---
title: "Update the info of a worker"
method: POST
path: "/public/onboarding/v1/update-worker"
tags: ["Onboarding flow"]
---

# Update the info of a worker

`POST /public/onboarding/v1/update-worker`

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

## Request body

- WorkerUpdateRequestV1
  - `workerId` string, uuid, required
  - `address` AddressDetailsV1, required: Address details.
    - `street` string, required: The street name of the address.
    - `houseNumber` integer, required: The house number of the address, excluding suffix. For a house number 123A, this would be 123.
    - `houseNumberAddition` string: House number suffix (if any). For a house number 123A, this would be 'A'.
    - `zipCode` string, required: The postal code of the address. Must be a post code that actually exists in the Netherlands.
    - `city` string, required: The city of the address.
    - `countryCode` string, required: The country code in ISO 3166-1 alpha-2 format.
  - `mobilePhoneNumber` string, required: The mobile number of the worker.
  - `emailAddress` string, email, required
  - `iban` string, required

## Response `200`

Successfully updated 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`: 7 breaking
  - added the new required request property `address`
  - added the new required request property `emailAddress`
  - added the new required request property `iban`
  - added the new required request property `mobilePhoneNumber`
  - …3 more
- **2026-09-29** `3352b56bb8fe`: 2 breaking, 5 warning, 14 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 `address`
  - removed the request property `emailAddress`
  - …17 more
- **2026-09-16** `ccf9834e5006`: 7 breaking
  - added the new required request property `address`
  - added the new required request property `emailAddress`
  - added the new required request property `iban`
  - added the new required request property `mobilePhoneNumber`
  - …3 more
- **2026-09-15** `8085d4c1ab80`: 2 breaking, 5 warning, 14 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 `address`
  - removed the request property `emailAddress`
  - …17 more
- **2026-09-10** `d26fed912541`: 7 breaking
  - added the new required request property `address`
  - added the new required request property `emailAddress`
  - added the new required request property `iban`
  - added the new required request property `mobilePhoneNumber`
  - …3 more

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