# Acknowledge receipt of one or more messages

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/acknowledgeMessage`

Base URL: `https://{host}`

Permanently deletes the specified messages from the database for the
authenticated recipient. Used after a client has received and handled
messages (e.g., after syncing or display).

## Authorization

- x-bsv-auth-identity-key (apiKey in header)

## Body

Content type: `application/json`

- `messageIds` (string[], required)
  Array of message IDs to acknowledge and delete.

Example:

```json
{
  "messageIds": [
    "string"
  ]
}
```

## Responses

### 200

Messages acknowledged (deleted) successfully.

- `status` ("success", required)

Example:

```json
{
  "status": "success"
}
```

### 400

Missing or invalid input, or no matching messages found.
Codes: `ERR_MESSAGE_ID_REQUIRED`, `ERR_INVALID_MESSAGE_ID`, `ERR_INVALID_ACKNOWLEDGMENT`

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```

### 401

Authentication required.

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```

### 500

Internal server error (`ERR_INTERNAL_ERROR`).

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```