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

# Bijwerken

Een bestaande vacature wijzigen. De aanroep vervangt de hele vacature.

Hiermee wijzig je een bestaande vacature. De aanroep vervangt de hele vacature door wat je meestuurt.

* **Aanroep:** `PUT /recruiter/vacancies/{id}`
* **Vereist recht:** Alle vacatures bewerken

{% hint style="warning" %}
Velden die je weglaat, worden leeggemaakt. Dat geldt ook voor `createdAt` en `recruiterId`. Haal de vacature daarom eerst op, pas aan wat je wilt wijzigen en stuur het geheel terug.
{% endhint %}

## Verplichte velden

| Veld              | Soort        | Toelichting                                                                                                                                              |
| ----------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `_id`             | tekst        | Het kenmerk van de vacature, in de inhoud van het verzoek. Cootje gebruikt dit veld om de vacature te vinden; het kenmerk in de URL wordt genegeerd      |
| `companyId`       | tekst        | Het `_id` van de klant. De klant moet al in Cootje staan, zie [Klant registreren](https://docs.cootje.com/cootje-api/klant-inlener/klant-registreren.md) |
| `title`           | tekst        | De titel van de vacature                                                                                                                                 |
| `description`     | tekst        | De omschrijving van de opdracht                                                                                                                          |
| `hoursPerWeek`    | geheel getal | Aantal uren per week, groter dan 0                                                                                                                       |
| `startDate`       | datum        | De startdatum van de opdracht                                                                                                                            |
| `endDate`         | datum        | De einddatum; mag niet voor de startdatum liggen                                                                                                         |
| `closureDateTime` | datum        | Inschrijven kan tot en met dit moment. Een publicatie stopt dan vanzelf                                                                                  |

## Optionele velden

Stuur deze velden mee met hun huidige waarde als je ze wilt behouden.

| Veld                             | Soort        | Toelichting                                                                                                                                                                 |
| -------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `createdAt`                      | datum        | Het moment van aanmaken. Stuur de bestaande waarde terug, anders raakt hij leeg                                                                                             |
| `allowedContractForms`           | lijst        | Toegestane contractvormen: `1` zzp, `3` loondienst, `4` tijdelijke arbeidsovereenkomst. Laat je het veld weg, dan zijn alle drie toegestaan. Een lege lijst wordt geweigerd |
| `internalClosureDateTime`        | datum        | De eigen deadline van de recruiter. Standaard één dag na `closureDateTime`; mag daar niet voor liggen                                                                       |
| `hourPrice`                      | getal        | Het inkooptarief per uur. Dit tarief is zichtbaar op de openbare vacaturepagina                                                                                             |
| `salesHourPrice`                 | getal        | Het verkooptarief per uur aan de klant. Alleen intern zichtbaar                                                                                                             |
| `location`                       | tekst        | De plaats waar het werk wordt gedaan                                                                                                                                        |
| `reference`                      | tekst        | Een eigen referentie, bijvoorbeeld het nummer uit je eigen systeem                                                                                                          |
| `expectedOutcome`                | tekst        | Het beoogde resultaat van de opdracht                                                                                                                                       |
| `assignmentRequirements`         | tekst        | De eisen aan de kandidaat                                                                                                                                                   |
| `assignmentRequirementsKnockOut` | ja/nee       | `true` als een kandidaat die niet aan de eisen voldoet afvalt. Standaard `false`                                                                                            |
| `preferredRequirements`          | tekst        | De wensen, naast de eisen                                                                                                                                                   |
| `competencies`                   | tekst        | De gevraagde competenties                                                                                                                                                   |
| `minimumYrsExperience`           | geheel getal | Het minimale aantal jaren ervaring. Standaard 0                                                                                                                             |
| `extensionPossible`              | ja/nee       | `true` als verlenging mogelijk is. Standaard `false`                                                                                                                        |
| `recruiterId`                    | tekst        | Het `_id` van de recruiter, uit `GET /recruiter/recruiters`                                                                                                                 |
| `notificationsEnabled`           | ja/nee       | Of er meldingen over deze vacature worden verstuurd. Standaard `true`                                                                                                       |

Datums zijn tekst in de vorm `2027-03-01T00:00:00`.

## Wat Cootje zelf doet

* `company` wordt opnieuw gevuld met de naam van de klant. Wat je in dit veld meestuurt, wordt genegeerd.
* `isCompleted` blijft zoals het was. Een vacature als vervuld markeren doe je met `POST /recruiter/vacancies/{id}/complete`, heropenen met `POST /recruiter/vacancies/{id}/reopen`.
* Wijzig je `closureDateTime` van een gepubliceerde vacature, dan schuift het einde van de publicatie mee.

## Voorbeeld

In dit voorbeeld gaat het aantal uren per week van 32 naar 36. De rest van de vacature gaat ongewijzigd mee.

```bash
curl -X PUT "https://mijn.cootje.com/api/recruiter/vacancies/c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "_id": "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
    "createdAt": "2027-01-12T09:30:00",
    "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
    "company": "Voorbeeld Zorg B.V.",
    "title": "Projectleider zorg",
    "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
    "expectedOutcome": "Het nieuwe roostersysteem is op alle afdelingen in gebruik.",
    "assignmentRequirements": "Minimaal 5 jaar ervaring als projectleider in de zorg.",
    "assignmentRequirementsKnockOut": true,
    "preferredRequirements": "Ervaring met roostersystemen.",
    "competencies": "Communicatief sterk, resultaatgericht.",
    "location": "Utrecht",
    "minimumYrsExperience": 5,
    "closureDateTime": "2027-02-01T17:00:00",
    "internalClosureDateTime": "2027-02-02T17:00:00",
    "startDate": "2027-03-01T00:00:00",
    "reference": "INK-2027-014",
    "endDate": "2027-08-31T00:00:00",
    "hoursPerWeek": 36,
    "hourPrice": 85,
    "salesHourPrice": 95,
    "allowedContractForms": [
      1,
      3,
      4
    ],
    "extensionPossible": true,
    "recruiterId": "",
    "isCompleted": false,
    "notificationsEnabled": true
  }'
```

Wil je alleen de recruiter wijzigen, gebruik dan `POST /recruiter/recruiters/assignments/vacancies`. Die aanroep laat de rest van de vacature ongemoeid.

## Wat je terugkrijgt

Niets: bij een geslaagde wijziging heeft het antwoord geen inhoud. Klopt de invoer niet, dan is het antwoord een lijst met fouten:

```json
[
  {
    "propertyName": "HoursPerWeek",
    "errorMessage": "Uur per week groter dan 0."
  }
]
```

Elke fout bevat daarnaast enkele technische velden, zoals `attemptedValue` en `errorCode`.

## Antwoorden

| Code  | Betekenis                                                 |
| ----- | --------------------------------------------------------- |
| `204` | De vacature is bijgewerkt. Het antwoord heeft geen inhoud |
| `400` | De invoer klopt niet. Het antwoord is de lijst met fouten |
| `401` | Geen geldig token, of het account mist het recht          |
