---
title: "[WIP] Shorten the duration of the placement contract upon request of the client company."
method: POST
path: "/public/placement/v1/update-placement-end-date"
tags: ["Placement"]
---

# \[WIP\] Shorten the duration of the placement contract upon request of the client company.

`POST /public/placement/v1/update-placement-end-date`

## Request

- Base URL: `https://api.maqqie.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maqqie.app/public/placement/v1/update-placement-end-date`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://maqqie.app/auth/realms/maqqie/protocol/openid-connect/token`
- TypeScript: <https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/placement/v1/update-placement-end-date/post.ts> (a function with typed inputs; its response is checked against the schema)

Shorten the duration of the contract to the given date.
Call this if and only if the client company invokes the agency clause (Dutch: uitzendbeding).

## Request body

- PlacementEndDateChangeRequestV1
  - `placementId` string, uuid, required: The unique id of the placement, as returned from /create-placement.
  - `contactId` string, uuid, required: The contact person that requests invocation of the agency clause. Must be a contact person of the client company that the placement is for.
  - `newEndDate` string, date, required: The new end date of the placement's contract. The contract runs up to and including this date. Must be >= contracted placement start date, and < contracted placement end date.

## Response `200`

Successfully shortened the contract to the requested end date

## Other responses

- `400`: The request could not be processed. This could be due to a number of reasons: * The request does not have all required data. * Data in the request is invalid. * Data in the request is inconsistent. * The operation is not allowed given the current state of the data.
- `401`: The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403`: The data that the request referred to is inaccessible to the caller.

## Changes

- **2026-09-29** `f9510f3f4b22`: 5 breaking
  - added the new required request property `contactId`
  - added the new required request property `newEndDate`
  - added the new required request property `placementId`
  - the request's body type changed from no type to `object`
  - …1 more
- **2026-09-29** `3352b56bb8fe`: 2 breaking, 3 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `contactId`
  - removed the request property `newEndDate`
  - …5 more
- **2026-09-16** `ccf9834e5006`: 5 breaking
  - added the new required request property `contactId`
  - added the new required request property `newEndDate`
  - added the new required request property `placementId`
  - the request's body type changed from no type to `object`
  - …1 more
- **2026-09-15** `8085d4c1ab80`: 2 breaking, 3 warning, 4 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `string` to no type for status `400`
  - removed the request property `contactId`
  - removed the request property `newEndDate`
  - …5 more
- **2026-09-10** `d26fed912541`: 5 breaking
  - added the new required request property `contactId`
  - added the new required request property `newEndDate`
  - added the new required request property `placementId`
  - the request's body type changed from no type to `object`
  - …1 more

[Operation history](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/placement/v1/update-placement-end-date/post.md)

---

[API](https://skmtc.dev/maqqie/apis/maqqie-public-api.md) - [All operations](https://skmtc.dev/maqqie/apis/maqqie-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maqqie/apis/maqqie-public-api/revisions/13ed331da2b2?raw)