# Reject an Address Book Entry

A pending entry is refused, a cooling one withdrawn — for good.

## Overview

- `pending_approval` → `rejected`, final: `200` with the entry, `rejectedBy` and `rejectedAt`. No body.
- `cooling` → `removed`, final: the entry is withdrawn before it is active, exactly as [Remove an Entry](https://docs.aureahub.com/docs/address-book-entry-remove.md) does it — `200` with the entry, `removedBy` and `removedAt`; its history, audit row and event are a removal's.
- Any role that may reject — who asked included, to take back a request. An active entry answers `409` `ADDRESS_BOOK_ENTRY_NOT_PENDING` (`Only an entry pending or cooling is rejected: an active entry is removed`, `details.approvalStep` `none`): remove it. `409` `ADDRESS_BOOK_ENTRY_FINAL` once rejected or removed.
- For `owner`, `tenantadmin` and `non_signing_admin`.

## Endpoint

### `POST /v1/address-book/entries/{entryId}/reject`

Authentication: bearer token required.

Rejects a pending entry, or withdraws a cooling one (final).

**Path parameters**

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

**Responses**

`200` Rejected

```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": "rejected",
  "version": 1,
  "requestedBy": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
  "requestedScope": "tenant",
  "requestedAt": "2026-10-08T08:00:12.000Z",
  "approval": null,
  "coolingPeriodSeconds": null,
  "activeAt": null,
  "coolingSecondsLeft": null,
  "proof": { "proven": false, "method": null, "provenAt": null },
  "rejectedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
  "rejectedAt": "2026-10-08T08:22:51.000Z",
  "removedBy": null,
  "removedAt": null,
  "createdAt": "2026-10-08T08:00:12.000Z",
  "updatedAt": "2026-10-08T08:22:51.000Z"
}
```

`409` Active

```json
{
  "statusCode": 409,
  "error": "ConflictError",
  "message": "Only an entry pending or cooling is rejected: an active entry is removed",
  "details": { "code": "ADDRESS_BOOK_ENTRY_NOT_PENDING", "status": "active", "approvalStep": "none" }
}
```

---

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