Candidates
Update candidate status
Change the status of a candidate in a sourcing.
PATCH
Update candidate status
First time? Set up Authentication
Learn how to authenticate your API requests with your API key.
statusHandle must be a global status (TO_BE_CONTACTED, CONTACTED, NOT_RETAINED, OUTREACH_SEQUENCE_STARTED) or a custom status defined in your workspace. Setting the status to NOT_RETAINED removes the candidate from the active pipeline and cancels any active outreach tasks.
Path parameters
string
required
The candidate id (from Get candidates or Add talent to sourcing).
Request body
string
required
The target status handle.
Response
Whensuccess is true, data includes candidateId, talentId, sourcingId, statusHandle, and updatedAt.
Errors
Update candidate status

