> 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/vacatures/verwijderen.md).

# Verwijderen

Een vacature definitief verwijderen, met alle koppelingen met kandidaten.

Hiermee verwijder je een vacature definitief.

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

{% hint style="danger" %}
Verwijderen kan niet ongedaan worden gemaakt. Samen met de vacature verdwijnen alle koppelingen met kandidaten, inclusief de sollicitaties en hun statusgeschiedenis, en de publicatie.
{% endhint %}

De kandidaten zelf blijven bestaan.

Wil je een vervulde vacature sluiten en de geschiedenis bewaren, gebruik dan `POST /recruiter/vacancies/{id}/complete` in plaats van verwijderen.

## Voorbeeld

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

## Antwoorden

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