---
title: "Werk een BESLUIT deels bij."
method: PATCH
path: "/besluiten/{uuid}"
tags: ["besluiten"]
---

# Werk een BESLUIT deels bij.

`PATCH /besluiten/{uuid}`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/besluiten/{uuid}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vng-realisatie/apis/besluiten-api/docs/besluiten/:uuid/patch.ts> (a function with typed inputs; its response is checked against the schema)

Er wordt gevalideerd op:
- uniciteit van `verantwoorlijkeOrganisatie` + `identificatie`
- geldigheid `verantwoorlijkeOrganisatie` RSIN
- geldigheid `besluittype` URL
- geldigheid `zaak` URL
- `datum` in het verleden of nu
- publicatie `besluittype` - `concept` moet `false` zijn

## Headers

- `X-NLX-Request-Application-Id` string
- `X-NLX-Request-User-Id` string
- `X-Audit-Toelichting` string

## Request body

- Besluit
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `identificatie` string: Identificatie van het besluit binnen de organisatie die het besluit heeft vastgesteld. Indien deze niet opgegeven is, dan wordt die gegenereerd.
  - `verantwoordelijkeOrganisatie` string, required: Het RSIN van de niet-natuurlijk persoon zijnde de organisatie die het besluit heeft vastgesteld.
  - `besluittype` string, uri, required: URL-referentie naar het BESLUITTYPE (in de Catalogi API).
  - `zaak` string, uri: URL-referentie naar de ZAAK (in de Zaken API) waarvan dit besluit uitkomst is.
  - `datum` string, date, required: De beslisdatum (AWB) van het besluit.
  - `toelichting` string: Toelichting bij het besluit.
  - `bestuursorgaan` string: Een orgaan van een rechtspersoon krachtens publiekrecht ingesteld of een persoon of college, met enig openbaar gezag bekleed onder wiens verantwoordelijkheid het besluit vastgesteld is.
  - `ingangsdatum` string, date, required: Ingangsdatum van de werkingsperiode van het besluit.
  - `vervaldatum` string, date, nullable: Datum waarop de werkingsperiode van het besluit eindigt.
  - `vervalreden` 'tijdelijk' | 'ingetrokken_overheid' | 'ingetrokken_belanghebbende': De omschrijving die aangeeft op grond waarvan het besluit is of komt te vervallen. Uitleg bij mogelijke waarden: * `tijdelijk` - Besluit met tijdelijke werking * `ingetrokken_overheid` - Besluit ingetrokken door overheid * `ingetrokken_belanghebbende` - Besluit ingetrokken o.v.v. belanghebbende
  - `vervalredenWeergave` string
  - `publicatiedatum` string, date, nullable: Datum waarop het besluit gepubliceerd wordt.
  - `verzenddatum` string, date, nullable: Datum waarop het besluit verzonden is.
  - `uiterlijkeReactiedatum` string, date, nullable: De datum tot wanneer verweer tegen het besluit mogelijk is.

## Response `200`

OK

- Besluit
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `identificatie` string: Identificatie van het besluit binnen de organisatie die het besluit heeft vastgesteld. Indien deze niet opgegeven is, dan wordt die gegenereerd.
  - `verantwoordelijkeOrganisatie` string, required: Het RSIN van de niet-natuurlijk persoon zijnde de organisatie die het besluit heeft vastgesteld.
  - `besluittype` string, uri, required: URL-referentie naar het BESLUITTYPE (in de Catalogi API).
  - `zaak` string, uri: URL-referentie naar de ZAAK (in de Zaken API) waarvan dit besluit uitkomst is.
  - `datum` string, date, required: De beslisdatum (AWB) van het besluit.
  - `toelichting` string: Toelichting bij het besluit.
  - `bestuursorgaan` string: Een orgaan van een rechtspersoon krachtens publiekrecht ingesteld of een persoon of college, met enig openbaar gezag bekleed onder wiens verantwoordelijkheid het besluit vastgesteld is.
  - `ingangsdatum` string, date, required: Ingangsdatum van de werkingsperiode van het besluit.
  - `vervaldatum` string, date, nullable: Datum waarop de werkingsperiode van het besluit eindigt.
  - `vervalreden` 'tijdelijk' | 'ingetrokken_overheid' | 'ingetrokken_belanghebbende': De omschrijving die aangeeft op grond waarvan het besluit is of komt te vervallen. Uitleg bij mogelijke waarden: * `tijdelijk` - Besluit met tijdelijke werking * `ingetrokken_overheid` - Besluit ingetrokken door overheid * `ingetrokken_belanghebbende` - Besluit ingetrokken o.v.v. belanghebbende
  - `vervalredenWeergave` string
  - `publicatiedatum` string, date, nullable: Datum waarop het besluit gepubliceerd wordt.
  - `verzenddatum` string, date, nullable: Datum waarop het besluit verzonden is.
  - `uiterlijkeReactiedatum` string, date, nullable: De datum tot wanneer verweer tegen het besluit mogelijk is.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `406`: Not acceptable
- `409`: Conflict
- `410`: Gone
- `415`: Unsupported media type
- `429`: Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/vng-realisatie/apis/besluiten-api.md) - [All operations](https://skmtc.dev/vng-realisatie/apis/besluiten-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vng-realisatie/apis/besluiten-api/revisions/4276af4e0a0f?raw)