SMsmartrecruiters
candidates

Update a candidate's status on primary assignment

Update a candidate's status on primary assignment. Please use PUT /candidates/{id}/jobs/{jobId}/status instead.

put/candidates/{id}/status

Request

  • Base URL
    https://api.smartrecruiters.com
  • URL
    https://api.smartrecruiters.com/candidates/{id}/status
  • Auth
    • API key in header x-smarttoken
    • or OAuth 2
      Authorization code: https://www.smartrecruiters.com/identity/oauth/allow
      Token URL: https://api.smartrecruiters.com/identity/oauth/token scopes: candidates_manage

Request body

status'LEAD' | 'NEW' | 'IN_REVIEW' | 'INTERVIEW' | 'OFFERED' | 'HIRED' | 'REJECTED' | 'WITHDRAWN' | 'TRANSFERRED' required
subStatusstring
startsOnstring date-time
reasonstring

id of rejection (GET /configuration/rejection-reasons) or withdrawal (GET /configuration/withdrawal-reasons) reason.

Changes

No recorded changes to this operation across all 1 revision of this API.