Delete a potential candidate

Permanently deletes a potential candidate. The delete cascades to its role and organization links. Scope: sourcing:write. Requires employer-write authority in one of the lead’s organizations (admins bypass). A role-activity audit entry is recorded for each active role before deletion.

Path parameters

Parameter	Type	Description
id	string	The potential-candidate id.

Example request

curl -X DELETE https://app.talent-ray.com/api/v1/sourcing/pc_1 \
  -H "Authorization: Bearer tr_YOUR_KEY"

Response

204 No Content — the lead and its links were deleted.

Status codes

Status	Meaning
204	Deleted.
401	No valid API key.
403	insufficient_scope (missing sourcing:write) or forbidden (no write authority in the lead’s org).
404	Not found, or not visible to the key.
429	Rate limit exceeded.