# Remove an Address Book Entry

Removed at once, whatever its state: no operation can send to it any more.

## Overview

- From `pending_approval`, `cooling` or `active`. `200` with the entry, `status` `removed`, with `removedBy` and `removedAt`.
- Final and soft: the entry and its history stay readable, and it never comes back — add the address again as a new entry, which is approved and cools like any other. Already rejected or removed: `409` `ADDRESS_BOOK_ENTRY_FINAL`.
- For `owner`, `tenantadmin`, `non_signing_admin` and `editor`.

## Endpoint

### `DELETE /v1/address-book/entries/{entryId}`

Authentication: bearer token required.

Removes an entry (final).

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `entryId` | string (uuid) | yes | The entry's id |

**Responses**

`200` Removed

```json
{
  "id": "8f3c2a71-5d4e-4b9a-a6c1-2e7f9d0b3c58",
  "accountId": null,
  "kind": "external",
  "family": "evm",
  "network": "mainnet",
  "chain": "base",
  "chainId": null,
  "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "walletId": null,
  "label": "Supplier payouts",
  "tags": ["suppliers"],
  "customerRefId": "SUP-0042",
  "status": "removed",
  "version": 1,
  "requestedBy": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
  "requestedScope": "tenant",
  "requestedAt": "2026-10-08T08:00:12.000Z",
  "approval": {
    "approvedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
    "approvedScope": "tenant",
    "approvedAt": "2026-10-08T08:30:00.000Z",
    "requiredApprovals": 1
  },
  "coolingPeriodSeconds": 86400,
  "activeAt": "2026-10-09T08:30:00.000Z",
  "coolingSecondsLeft": null,
  "proof": { "proven": true, "method": "eip191", "provenAt": "2026-10-08T08:10:41.000Z" },
  "rejectedBy": null,
  "rejectedAt": null,
  "removedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
  "removedAt": "2026-11-02T15:20:09.000Z",
  "createdAt": "2026-10-08T08:00:12.000Z",
  "updatedAt": "2026-11-02T15:20:09.000Z"
}
```

`409` Final

```json
{
  "statusCode": 409,
  "error": "ConflictError",
  "message": "A removed entry never changes again",
  "details": { "code": "ADDRESS_BOOK_ENTRY_FINAL", "status": "removed" }
}
```

---

Web version: https://docs.aureahub.com/#address-book-entry-remove