> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/recruitment/kandidaten/verwijderen.md).

# Verwijderen

Een kandidaat definitief verwijderen, met alle koppelingen met vacatures.

Hiermee verwijder je een kandidaat definitief.

* **Aanroep:** `DELETE /recruiter/candidates/{id}`
* **Vereist recht:** Alle kandidaten bewerken
* **Verplicht:** `id` in de URL, het `_id` van de kandidaat
* **Optioneel:** niets

{% hint style="danger" %}
Verwijderen kan niet ongedaan worden gemaakt. Samen met de kandidaat verdwijnen alle koppelingen met vacatures, inclusief de sollicitaties en hun statusgeschiedenis, en de geüploade bestanden.
{% endhint %}

Wil je iemand alleen uit de matching halen, zet dan `isAvailable` op `false` via [Bijwerken](https://docs.cootje.com/cootje-api/recruitment/kandidaten/bijwerken.md).

## Voorbeeld

```bash
curl -X DELETE "https://mijn.cootje.com/api/recruiter/candidates/KANDIDAAT_ID" \
  -H "Authorization: Bearer JOUW_TOKEN"
```

## Antwoorden

| Code  | Betekenis                                                  |
| ----- | ---------------------------------------------------------- |
| `204` | De kandidaat is verwijderd. Het antwoord heeft geen inhoud |
| `401` | Geen geldig token, of het account mist het recht           |
