Skip to main content
DELETE
Remove candidate from sourcing

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
Removes a candidate from a sourcing flow by setting its status to NOT_RETAINED. The candidate row is kept (not hard-deleted): it is excluded from the active pipeline and any active outreach tasks are cancelled. This is equivalent to calling Update candidate status with statusHandle: "NOT_RETAINED".

Path parameters

string
required
The candidate id to remove.

Response

When success is true, data includes candidateId, talentId, sourcingId, statusHandle (NOT_RETAINED), updatedAt, and removed: true.

Errors