Skip to main content
PATCH
Update candidate status

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
Updates the status of a candidate in your workspace. The 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

When success is true, data includes candidateId, talentId, sourcingId, statusHandle, and updatedAt.

Errors