---
title: "Deletes a Candidate"
method: DELETE
path: "/api/2026-07-01/resources/ats/candidates/{id}"
tags: ["Ats > Candidate"]
---

# Deletes a Candidate

`DELETE /api/2026-07-01/resources/ats/candidates/{id}`

Deletes a candidate from the ATS

## Path parameters

- `id` string, required

## Response `200`

OK

- AtsCandidate
  - `id` string, required — identifier of the candidate.
  - `company_id` string — company identifier.
  - `first_name` string, required — name of the candidate.
  - `last_name` string, required — last name of the candidate.
  - `full_name` string, required — full name of the candidate.
  - `email` string — email of the candidate.
  - `talent_pool` boolean, required — is the candidate part of talent pool?
  - `phone_number` string — phone number of the candidate.
  - `created_at` string, required — creation date of the candidate.
  - `updated_at` string, required — last update of the candidate.
  - `consent_given_at` string — date when the consent was given.
  - `inactive_since` string — date when the candidate became inactive.
  - `ats_job_posting_ids` string[] — list of job posting identifiers.
  - `personal_url` string — personal web resource from the candidate.
  - `consent_expiration_date` string — date when the consent expires.
  - `consent_to_talent_pool` boolean — consent to talent pool.
  - `medium` string — specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.
  - `source_id` string — candidate source identifier, refers to ats/candidate_sources endpoint.
  - `gender` 'female' | 'male' | 'unanswered' | 'other' — gender of the candidate.
  - `score` number — score of the candidate.

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/1a6bffb20f7d?raw)