---
title: "Replace officials for multiple Application List Entries."
method: POST
path: "/application-lists/{listId}/entries/officials"
tags: ["application-list-entries"]
---

# Replace officials for multiple Application List Entries.

`POST /application-lists/{listId}/entries/officials`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/application-lists/{listId}/entries/officials`
- Auth: none declared

Atomically replaces the full officials array for each specified entry in the source list (path `listId`). If any entry cannot be updated, no officials are changed.   NOTE: Duplicate entryIds will result in an error

## Path parameters

- `listId` string, uuid, required

## Request body

- BulkOfficialsUpdateDto: Replace officials for multiple Application List Entries in one atomic operation.
  - `entryIds` string[], required: Array of entry IDs whose officials should be replaced. All must belong to the list in the path.
  - `officials` Official[], required: An array of Officials who will decide the outcome of each selected Application. A maximum of 4 officials may be supplied, with no more than 3 MAGISTRATE entries and no more than 1 CLERK entry.
    - `title` string: Prefix before a persons name.
    - `surname` string: The persons family name.
    - `forename` string: The persons first name.
    - `type` 'MAGISTRATE' | 'CLERK': The type of Official hearing the application.

## Response `204`

Officials replaced for all entries. No response body.

## Other responses

- `400`: Invalid request parameters.
- `401`: Authentication required or token invalid.
- `403`: Authenticated but not permitted to perform this action.
- `404`: The requested resource was not found.
- `409`: Conflict with the current state of the resource.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api.md) - [All operations](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hm-courts-and-tribunals-service/apis/applications-register-api/revisions/36521cfe1ab7?raw)