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

# Maak een OBJECT-VERZOEK relatie aan.

`POST /objectverzoeken`

## Request

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

Maak een OBJECT-VERZOEK relatie aan.

**LET OP: Dit endpoint hoor je als consumer niet zelf aan te spreken.**

Andere API's, zoals de Zaken API, gebruiken dit
endpoint bij het synchroniseren van relaties.

## Headers

- `Content-Type` 'application/json', required

## Request body

- ObjectVerzoek
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.
  - `object` string, uri, required: URL-referentie naar het gerelateerde OBJECT (in een andere API).
  - `objectType` 'zaak', required: Het type van het gerelateerde OBJECT. Uitleg bij mogelijke waarden: * `zaak` - Zaak

## Response `201`

Created

- ObjectVerzoek
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.
  - `object` string, uri, required: URL-referentie naar het gerelateerde OBJECT (in een andere API).
  - `objectType` 'zaak', required: Het type van het gerelateerde OBJECT. Uitleg bij mogelijke waarden: * `zaak` - Zaak

## 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
  - added the new required `header` request parameter `Content-Type`
- **2020-07-09** `a7cd30866623`: 1 warning
  - deleted the `header` request parameter `Content-Type`
- **2020-07-09** `d63999b3259d`: 2 breaking, 1 warning, 1 info
  - the `verzoek` request property's minLength was increased from `0` to `1`
  - the `object` response property's maxLength was increased from `200` to `1000` for the response status `201`
  - the `verzoek` request property's maxLength was set to `1000`
  - the `object` request property's maxLength was increased from `200` 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/objectverzoeken/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)