--- title: "Werk een CONTACTMOMENT deels bij." method: PATCH path: "/contactmomenten/{uuid}" tags: ["contactmomenten"] --- # Werk een CONTACTMOMENT deels bij. `PATCH /contactmomenten/{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/contactmomenten/{uuid}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Werk een CONTACTMOMENT deels bij. ## Headers - `Content-Type` 'application/json', required - `X-NLX-Logrecord-ID` string - `X-Audit-Toelichting` string ## Request body - ContactMoment - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object. - `vorigContactmoment` string, uri, nullable: URL-referentie naar het vorige CONTACTMOMENT. - `volgendContactmoment` string, uri, nullable: URL-referentie naar het volgende CONTACTMOMENT. - `bronorganisatie` string, required: Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de klantinteractie heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `registratiedatum` string, date-time: De datum en het tijdstip waarop het CONTACTMOMENT is geregistreerd. - `kanaal` string: Het communicatiekanaal waarlangs het CONTACTMOMENT gevoerd wordt - `voorkeurskanaal` string: Het communicatiekanaal dat voor opvolging van deze klantinteractie de voorkeur heeft van de KLANT. - `voorkeurstaal` string: Een ISO 639-2/B taalcode waarin de voorkeurstaal van de KLANT voor de opvolging van deze klantinteractie is vastgelegd. Voorbeeld: `nld`. Zie: https://www.iso.org/standard/4767.html - `tekst` Tekst - `inhoud` string, required: Een toelichting die inhoudelijk de klantinteractie van de klant beschrijft. - `formaat` 'plain' | 'markdown', required: Er zijn twee formaten waaruit gekozen kan worden: `plain` en `markdown`. Dit zijn afkortingen van de media types: `text/plain; charset=utf-8` (zie [RFC3676](https://www.rfc-editor.org/rfc/rfc3676.html)) en `text/markdown; charset=utf-8` (zie [RFC7763](https://www.rfc-editor.org/rfc/rfc7763.html)) zoals gepubliceerd in de lijst van [IANA](https://www.iana.org/assignments/media-types/media-types.xhtml). - `formaatWeergave` string, required: Volledige weergave van het formaat volgens IANA zoals hierboven beschreven. - `onderwerpLinks` string[]: Eén of meerdere links naar een product, webpagina of andere entiteit zodat contactmomenten gegroepeerd kunnen worden op onderwerp. - `initiatiefnemer` 'gemeente' | 'klant': De partij die het contact heeft geïnitieerd. - `medewerker` string, uri: URL-referentie naar een medewerker - `medewerkerIdentificatie` Medewerker, nullable - `identificatie` string: Een korte unieke aanduiding van de MEDEWERKER. - `achternaam` string: De achternaam zoals de MEDEWERKER die in het dagelijkse verkeer gebruikt. - `voorletters` string: De verzameling letters die gevormd wordt door de eerste letter van alle in volgorde voorkomende voornamen. - `voorvoegselAchternaam` string: Dat deel van de geslachtsnaam dat voorkomt in Tabel 36 (GBA), voorvoegseltabel, en door een spatie van de geslachtsnaam is ## Response `200` OK - ContactMoment - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object. - `vorigContactmoment` string, uri, nullable: URL-referentie naar het vorige CONTACTMOMENT. - `volgendContactmoment` string, uri, nullable: URL-referentie naar het volgende CONTACTMOMENT. - `bronorganisatie` string, required: Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de klantinteractie heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef - `registratiedatum` string, date-time: De datum en het tijdstip waarop het CONTACTMOMENT is geregistreerd. - `kanaal` string: Het communicatiekanaal waarlangs het CONTACTMOMENT gevoerd wordt - `voorkeurskanaal` string: Het communicatiekanaal dat voor opvolging van deze klantinteractie de voorkeur heeft van de KLANT. - `voorkeurstaal` string: Een ISO 639-2/B taalcode waarin de voorkeurstaal van de KLANT voor de opvolging van deze klantinteractie is vastgelegd. Voorbeeld: `nld`. Zie: https://www.iso.org/standard/4767.html - `tekst` Tekst - `inhoud` string, required: Een toelichting die inhoudelijk de klantinteractie van de klant beschrijft. - `formaat` 'plain' | 'markdown', required: Er zijn twee formaten waaruit gekozen kan worden: `plain` en `markdown`. Dit zijn afkortingen van de media types: `text/plain; charset=utf-8` (zie [RFC3676](https://www.rfc-editor.org/rfc/rfc3676.html)) en `text/markdown; charset=utf-8` (zie [RFC7763](https://www.rfc-editor.org/rfc/rfc7763.html)) zoals gepubliceerd in de lijst van [IANA](https://www.iana.org/assignments/media-types/media-types.xhtml). - `formaatWeergave` string, required: Volledige weergave van het formaat volgens IANA zoals hierboven beschreven. - `onderwerpLinks` string[]: Eén of meerdere links naar een product, webpagina of andere entiteit zodat contactmomenten gegroepeerd kunnen worden op onderwerp. - `initiatiefnemer` 'gemeente' | 'klant': De partij die het contact heeft geïnitieerd. - `medewerker` string, uri: URL-referentie naar een medewerker - `medewerkerIdentificatie` Medewerker, nullable - `identificatie` string: Een korte unieke aanduiding van de MEDEWERKER. - `achternaam` string: De achternaam zoals de MEDEWERKER die in het dagelijkse verkeer gebruikt. - `voorletters` string: De verzameling letters die gevormd wordt door de eerste letter van alle in volgorde voorkomende voornamen. - `voorvoegselAchternaam` string: Dat deel van de geslachtsnaam dat voorkomt in Tabel 36 (GBA), voorvoegseltabel, en door een spatie van de geslachtsnaam 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 ## Changes - **2022-06-13** `be7c3ce11319`: 1 breaking, 1 warning, 2 info - removed the enum value `plain_text` of the request property `tekst/formaat` - added the new `plain` enum value to the `tekst/formaat` response property for the response status `200` - added the new `plain` enum value to the request property `tekst/formaat` - removed the `plain_text` enum value from the `tekst/formaat` response property for the response status `200` - **2022-06-13** `5a6cf8f199bb`: 1 info - added the required property `tekst/formaatWeergave` to the response with the `200` status - **2022-06-13** `5d8d529c3b9a`: 2 breaking, 2 warning, 4 info - removed the enum value `text/markdown` of the request property `tekst/formaat` - removed the enum value `text/plain` of the request property `tekst/formaat` - added the new `markdown` enum value to the `tekst/formaat` response property for the response status `200` - added the new `plain_text` enum value to the `tekst/formaat` response property for the response status `200` - …4 more - **2022-06-13** `9d9bb8df33c5`: 2 breaking, 2 warning, 4 info - removed the enum value `markdown` of the request property `tekst/formaat` - removed the enum value `plain_text` of the request property `tekst/formaat` - added the new `text/markdown` enum value to the `tekst/formaat` response property for the response status `200` - added the new `text/plain` enum value to the `tekst/formaat` response property for the response status `200` - …4 more - …earlier changes not shown [Operation history](https://skmtc.dev/vng-realisatie/apis/contactmomenten-api/changes/contactmomenten/:uuid/patch.md) --- [API](https://skmtc.dev/vng-realisatie/apis/contactmomenten-api.md) - [All operations](https://skmtc.dev/vng-realisatie/apis/contactmomenten-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vng-realisatie/apis/contactmomenten-api/revisions/be7c3ce11319?raw)