# Approve a Settings Change

The change waiting for its approval is applied.

## Overview

- `200`, `{ state, settings, change }` with `state` `applied` and the settings as they are now. No body.
- Where your tenant's quorum applies — the institutional profile, or two administrators or more — an administrator other than who asked approves: `403` `ADDRESS_BOOK_QUORUM_REQUESTER`. A tenant with a single administrator approves its own change. A cooling period under 24 hours is refused again on the institutional profile (`400` `ADDRESS_BOOK_COOLING_TOO_SHORT`).
- `404` `ADDRESS_BOOK_SETTINGS_CHANGE_NOT_FOUND`; `409` `ADDRESS_BOOK_SETTINGS_CHANGE_NOT_PENDING` (with `details.status`) once it was decided.
- For `owner`, `tenantadmin` and `non_signing_admin`.

## Endpoint

### `POST /v1/address-book/settings/changes/{changeId}/approve`

Authentication: bearer token required.

Applies a settings change waiting for its approval.

**Path parameters**

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

**Responses**

`200` Applied

```json
{
  "state": "applied",
  "settings": {
    "mode": "off",
    "enforced": false,
    "settings": { "coolingPeriodSeconds": 3600, "proofRequired": true, "oneTimeAddresses": false },
    "effectiveCoolingPeriodSeconds": 3600,
    "pendingChange": null
  },
  "change": {
    "id": "5b0d3e92-7c1a-4e68-b4f9-0a2c6d8e1f37",
    "coolingPeriodSeconds": 3600,
    "proofRequired": null,
    "oneTimeAddresses": null,
    "lowers": true,
    "status": "applied",
    "requiredApprovals": 1,
    "requestedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
    "requestedScope": "tenant",
    "createdAt": "2026-10-08T09:05:00.000Z",
    "decidedBy": "0f8e7d6c-5b4a-4392-8170-6e5d4c3b2a19",
    "decidedScope": "tenant",
    "decidedAt": "2026-10-08T10:12:44.000Z"
  }
}
```

`403` Who asked

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "The tenant's quorum applies: an administrator other than who asked approves this change",
  "details": { "code": "ADDRESS_BOOK_QUORUM_REQUESTER" }
}
```

---

Web version: https://docs.aureahub.com/#address-book-change-approve