---
title: "Update identity data of a worker"
method: POST
path: "/public/worker/v1/update-identity-data"
tags: ["Worker"]
---

# Update identity data of a worker

`POST /public/worker/v1/update-identity-data`

## 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/worker/v1/update-identity-data`
- 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/worker/v1/update-identity-data/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- UpdateIdentityDataRequestV1
  - `bsnDocument` string: The base64-encoded image of the bsn document.
  - `base64DocumentBack` string, required: The base64-encoded image of the back of the identity document.
  - `base64DocumentFront` string, required: The base64-encoded image of the front of the identity document.
  - `documentType` 'IDENTITY_CARD' | 'PASSPORT' | 'RESIDENCE_PERMIT', required
  - `documentNumber` string, required: The identification document number.
  - `documentExpiryDate` string, date, required: The expiration date of the identification document.
  - `documentNationality` string, required: The country code in ISO 3166-1 alpha-2 format.

## Response `200`

Successfully updated identity data of a worker

## 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`: 4 breaking, 2 info
  - added the new required request property `workerId`
  - added `#/components/schemas/IdentityDocumentV1` to the request body `allOf` list
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `string` for status `400`
  - …2 more
- **2026-09-29** `3352b56bb8fe`: 2 breaking, 4 warning, 6 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 `#/components/schemas/IdentityDocumentV1` from the request body `allOf` list
  - removed the request property `bsn`
  - …8 more
- **2026-09-16** `ccf9834e5006`: 4 breaking, 2 info
  - added the new required request property `workerId`
  - added `#/components/schemas/IdentityDocumentV1` to the request body `allOf` list
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `string` for status `400`
  - …2 more
- **2026-09-15** `8085d4c1ab80`: 2 breaking, 4 warning, 6 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 `#/components/schemas/IdentityDocumentV1` from the request body `allOf` list
  - removed the request property `bsn`
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/maqqie/apis/maqqie-public-api/changes/public/worker/v1/update-identity-data/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)