Skip to main content
This action is irreversible. Deleting a candidate permanently destroys, with no undo and no way for Alex support to recover it:
  • the candidate record and all of their contact details
  • every interview session and application belonging to them
  • all interview transcripts, scores, feedback, and generated reports
  • their stored resume file
  • all interview recordings — audio and video
There is no soft delete, no trash, and no recovery window. Once the call returns, the data is gone. Use the snapshot in the response as your own record of what was removed.
Identify the candidate with exactly one of candidateId, candidateExternalId, or email. Supplying none — or more than one — returns a 400.

​
Scoping

Every lookup is scoped to the company that owns the API key. You cannot delete a candidate belonging to another company, and an identifier that exists elsewhere in Alex but not in your company returns 404.

​
Confirming media was removed

Database records are deleted during the call. Stored files (recordings, reports and resumes) are then deleted by a background job that retries until they are gone. data.assets.cleanupSucceeded is true once that job has started, and false if it could not be started; the records are deleted either way. If you must guarantee that recordings and resumes are gone — for a data-retention or GDPR obligation, for example — alert on that flag rather than on the HTTP status alone.