update_candidate_status

Updates the status of a candidate in the authenticated workspace.

Input

Parameter	Type	Required	Description
`candidateId`	string	Yes	Candidate id to update.
`statusHandle`	string	Yes	Target status handle. A global status (`TO_BE_CONTACTED`, `CONTACTED`, `NOT_RETAINED`, `OUTREACH_SEQUENCE_STARTED`) or a custom workspace status.

JSON block with success: true and data containing candidateId, talentId, sourcingId, statusHandle, and updatedAt.

session not found, Not found, or Validation error when the status handle is unknown.