---
title: "Maak een ROL aan bij een ZAAK."
method: POST
path: "/rollen"
tags: ["rollen"]
---

# Maak een ROL aan bij een ZAAK.

`POST /rollen`

Maak een ROL aan bij een ZAAK.

## Headers

- `Content-Type` 'application/json', required
- `X-NLX-Logrecord-ID` string
- `X-Audit-Toelichting` string

## Request body

- Rol
  - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `uuid` string, uuid, required — Unieke resource identifier (UUID4)
  - `zaak` string, uri, required — URL-referentie naar de ZAAK.
  - `betrokkene` string, uri — URL-referentie naar een betrokkene gerelateerd aan de ZAAK.
  - `betrokkeneType` 'natuurlijk_persoon' | 'niet_natuurlijk_persoon' | 'vestiging' | 'organisatorische_eenheid' | 'medewerker', required
  - `afwijkendeNaamBetrokkene` string — De naam van de betrokkene waaronder deze in relatie tot de zaak aangesproken wil worden.
  - `roltype` string, uri, required — URL-referentie naar een roltype binnen het ZAAKTYPE van de ZAAK.
  - `omschrijving` string, required — Omschrijving van de aard van de ROL, afgeleid uit het ROLTYPE.
  - `omschrijvingGeneriek` string, required — Algemeen gehanteerde benaming van de aard van de ROL, afgeleid uit het ROLTYPE. Uitleg bij mogelijke waarden: * `adviseur` - (Adviseur) Kennis in dienst stellen van de behandeling van (een deel van) een zaak. * `behandelaar` - (Behandelaar) De vakinhoudelijke behandeling doen van (een deel van) een zaak. * `belanghebbende` - (Belanghebbende) Vanuit eigen en objectief belang rechtstreeks betrokken zijn bij de behandeling en/of de uitkomst van een zaak. * `beslisser` - (Beslisser) Nemen van besluiten die voor de uitkomst van een zaak noodzakelijk zijn. * `initiator` - (Initiator) Aanleiding geven tot de start van een zaak .. * `klantcontacter` - (Klantcontacter) Het eerste aanspreekpunt zijn voor vragen van burgers en bedrijven .. * `zaakcoordinator` - (Zaakcoördinator) Er voor zorg dragen dat de behandeling van de zaak in samenhang uitgevoerd wordt conform de daarover gemaakte afspraken. * `mede_initiator` - Mede-initiator
  - `roltoelichting` string, required
  - `registratiedatum` string, date-time, required — De datum waarop dit object is geregistreerd.
  - `indicatieMachtiging` union — Indicatie machtiging Uitleg bij mogelijke waarden: * `gemachtigde` - De betrokkene in de rol bij de zaak is door een andere betrokkene bij dezelfde zaak gemachtigd om namens hem of haar te handelen * `machtiginggever` - De betrokkene in de rol bij de zaak heeft een andere betrokkene bij dezelfde zaak gemachtigd om namens hem of haar te handelen
    - 'gemachtigde' | 'machtiginggever'
    - ''
  - `contactpersoonRol` ContactPersoonRol, nullable — De gegevens van de persoon die anderen desgevraagd in contact brengt met medewerkers van de BETROKKENE, een NIET-NATUURLIJK PERSOON of VESTIGING zijnde, of met BETROKKENE zelf, een NATUURLIJK PERSOON zijnde , vanuit het belang van BETROKKENE in haar ROL bij een ZAAK.
    - `emailadres` string, email — Elektronich postadres waaronder de contactpersoon in de regel bereikbaar is.
    - `functie` string — De aanduiding van de taken, rechten en plichten die de contactpersoon heeft binnen de organisatie van BETROKKENE.
    - `telefoonnummer` string — Telefoonnummer waaronder de contactpersoon in de regel bereikbaar is.
    - `naam` string, required — De opgemaakte naam van de contactpersoon namens de BETROKKENE.
  - `statussen` string[], required — De BETROKKENE die in zijn/haar ROL in een ZAAK heeft geregistreerd dat STATUSsen in die ZAAK bereikt zijn.

## Response `201`

Created

- Rol
  - `url` string, uri, required — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `uuid` string, uuid, required — Unieke resource identifier (UUID4)
  - `zaak` string, uri, required — URL-referentie naar de ZAAK.
  - `betrokkene` string, uri — URL-referentie naar een betrokkene gerelateerd aan de ZAAK.
  - `betrokkeneType` 'natuurlijk_persoon' | 'niet_natuurlijk_persoon' | 'vestiging' | 'organisatorische_eenheid' | 'medewerker', required
  - `afwijkendeNaamBetrokkene` string — De naam van de betrokkene waaronder deze in relatie tot de zaak aangesproken wil worden.
  - `roltype` string, uri, required — URL-referentie naar een roltype binnen het ZAAKTYPE van de ZAAK.
  - `omschrijving` string, required — Omschrijving van de aard van de ROL, afgeleid uit het ROLTYPE.
  - `omschrijvingGeneriek` string, required — Algemeen gehanteerde benaming van de aard van de ROL, afgeleid uit het ROLTYPE. Uitleg bij mogelijke waarden: * `adviseur` - (Adviseur) Kennis in dienst stellen van de behandeling van (een deel van) een zaak. * `behandelaar` - (Behandelaar) De vakinhoudelijke behandeling doen van (een deel van) een zaak. * `belanghebbende` - (Belanghebbende) Vanuit eigen en objectief belang rechtstreeks betrokken zijn bij de behandeling en/of de uitkomst van een zaak. * `beslisser` - (Beslisser) Nemen van besluiten die voor de uitkomst van een zaak noodzakelijk zijn. * `initiator` - (Initiator) Aanleiding geven tot de start van een zaak .. * `klantcontacter` - (Klantcontacter) Het eerste aanspreekpunt zijn voor vragen van burgers en bedrijven .. * `zaakcoordinator` - (Zaakcoördinator) Er voor zorg dragen dat de behandeling van de zaak in samenhang uitgevoerd wordt conform de daarover gemaakte afspraken. * `mede_initiator` - Mede-initiator
  - `roltoelichting` string, required
  - `registratiedatum` string, date-time, required — De datum waarop dit object is geregistreerd.
  - `indicatieMachtiging` union — Indicatie machtiging Uitleg bij mogelijke waarden: * `gemachtigde` - De betrokkene in de rol bij de zaak is door een andere betrokkene bij dezelfde zaak gemachtigd om namens hem of haar te handelen * `machtiginggever` - De betrokkene in de rol bij de zaak heeft een andere betrokkene bij dezelfde zaak gemachtigd om namens hem of haar te handelen
    - 'gemachtigde' | 'machtiginggever'
    - ''
  - `contactpersoonRol` ContactPersoonRol, nullable — De gegevens van de persoon die anderen desgevraagd in contact brengt met medewerkers van de BETROKKENE, een NIET-NATUURLIJK PERSOON of VESTIGING zijnde, of met BETROKKENE zelf, een NATUURLIJK PERSOON zijnde , vanuit het belang van BETROKKENE in haar ROL bij een ZAAK.
    - `emailadres` string, email — Elektronich postadres waaronder de contactpersoon in de regel bereikbaar is.
    - `functie` string — De aanduiding van de taken, rechten en plichten die de contactpersoon heeft binnen de organisatie van BETROKKENE.
    - `telefoonnummer` string — Telefoonnummer waaronder de contactpersoon in de regel bereikbaar is.
    - `naam` string, required — De opgemaakte naam van de contactpersoon namens de BETROKKENE.
  - `statussen` string[], required — De BETROKKENE die in zijn/haar ROL in een ZAAK heeft geregistreerd dat STATUSsen in die ZAAK bereikt zijn.

## Other responses

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

---

[API](https://skmtc.net/vng-realisatie/apis/zaken-api.md) · [All operations](https://skmtc.net/vng-realisatie/apis/zaken-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vng-realisatie/zaken-api/revisions/e4bb3b85eb48/schema)