# Reject a Settings Change

The change waiting for its approval is refused — or withdrawn, by who asked for it.

## Overview

- `200`, `{ state, settings, change }`: `state` `rejected`, or `withdrawn` when who asked rejects it. The settings stay as they were. No body.
- `404` `ADDRESS_BOOK_SETTINGS_CHANGE_NOT_FOUND`; `409` `ADDRESS_BOOK_SETTINGS_CHANGE_NOT_PENDING` once it was decided.
- For `owner`, `tenantadmin` and `non_signing_admin`.

## Endpoint

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

Authentication: bearer token required.

Refuses, or withdraws, a settings change waiting for its approval.

**Path parameters**

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

**Responses**

`200` Withdrawn

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

`409` Decided

```json
{
  "statusCode": 409,
  "error": "ConflictError",
  "message": "Only a change waiting for its approval is decided",
  "details": { "code": "ADDRESS_BOOK_SETTINGS_CHANGE_NOT_PENDING", "status": "applied" }
}
```

---

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