---
title: "Maak een VERZOEK-INFORMATIEOBJECT relatie aan."
method: POST
path: "/verzoekinformatieobjecten"
tags: ["verzoekinformatieobjecten"]
---

# Maak een VERZOEK-INFORMATIEOBJECT relatie aan.

`POST /verzoekinformatieobjecten`

## Request

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

Registreer een INFORMATIEOBJECT bij een VERZOEK. Er worden twee types van
relaties met andere objecten gerealiseerd:

**Er wordt gevalideerd op**
- geldigheid `verzoek` URL
- geldigheid `informatieobject` URL
- de combinatie `informatieobject` en `verzoek` moet uniek zijn

**Opmerkingen**
- Bij het aanmaken wordt ook in de Documenten API de gespiegelde relatie
  aangemaakt, echter zonder de relatie-informatie.

## Headers

- `Content-Type` 'application/json', required
- `X-NLX-Request-Application-Id` string
- `X-NLX-Request-User-Id` string
- `X-Audit-Toelichting` string

## Request body

- VerzoekInformatieObject
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `informatieobject` string, uri, required: URL-referentie naar het INFORMATIEOBJECT (in de Documenten API) waarin (een deel van) het verzoek beschreven is of aanvullende informatie biedt bij het VERZOEK.
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.

## Response `201`

Created

- VerzoekInformatieObject
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `informatieobject` string, uri, required: URL-referentie naar het INFORMATIEOBJECT (in de Documenten API) waarin (een deel van) het verzoek beschreven is of aanvullende informatie biedt bij het VERZOEK.
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.

## 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

## Changes

> 9 revisions in range; 1 not diffed.

- **2022-06-13** `1f46a04e9dae`: 1 breaking, 3 info
  - added the new required `header` request parameter `Content-Type`
  - added the new optional `header` request parameter `X-Audit-Toelichting`
  - added the new optional `header` request parameter `X-NLX-Request-Application-Id`
  - added the new optional `header` request parameter `X-NLX-Request-User-Id`
- **2020-07-09** `a7cd30866623`: 1 warning
  - deleted the `header` request parameter `Content-Type`
- **2020-07-09** `d63999b3259d`: 1 breaking, 1 warning
  - the `verzoek` request property's minLength was increased from `0` to `1`
  - the `verzoek` request property's maxLength was set to `1000`
- **2020-07-09** `1fba4e92a46d`: 2 info
  - the security scope `verzoeken.aanmaken` was added to the endpoint's security scheme `JWT-Claims`
  - the security scope `klanten.aanmaken` was removed from the endpoint's security scheme `JWT-Claims`

[Operation history](https://skmtc.dev/vng-realisatie/apis/verzoeken-api/changes/verzoekinformatieobjecten/post.md)

---

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