Remove candidate from job
Remove a candidate from a job pipeline (soft archive).
Important: This only removes the candidacy — the association between the person and the job. The person record remains in the database and is not deleted. Stage history and other job-linked candidacy data stay retained on the archived candidate row.
To add the person back to a job later, use POST /v1/persons or PATCH /v1/persons/{id} with job_id (or the matching MCP tools). Get candidate IDs from POST /v1/persons/search with include: ["candidates"] or from GET /v1/candidates/{id}.
Requires the candidates:delete API key scope.
Authorizations
Authenticate with a Bearer token: API key, OAuth token, or session token.
Path Parameters
Candidate UUID