# Lift a Freeze

Let a frozen user, wallet or account act again, on every server, from the moment this answers.

## Overview

- `reason`: 1 to 500 characters, kept as `liftReason` with who lifted it and when. `200` with the freeze, now `active: false`.
- Never a freeze of your tenant itself, nor one an Aurea administrator placed: `403` `FREEZE_LIFT_PLATFORM_ONLY` (`Only an Aurea administrator lifts this freeze.`). Never a freeze of yourself, of one of your wallets, or of an account you own — your default account included: `403` `FREEZE_SELF`.
- `404` `FREEZE_NOT_FOUND` (`No such freeze here.`) for a freeze that is not your tenant's; `409` `FREEZE_NOT_ACTIVE` (`This freeze is already lifted.`).
- Same roles as [Freeze](https://docs.aureahub.com/docs/freezes-create.md).

## Endpoint

### `POST /v1/admin/tenants/{id}/freezes/{freezeId}/lift`

Authentication: bearer token required.

Lifts a freeze of the tenant's user or wallet.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |
| `freezeId` | string | yes | The freeze's id |

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `reason` | string | yes | 1–500 characters |

**Responses**

`200` Lifted

```json
{
  "id": "a3e9c1d7-5b2f-4e86-9d0a-7c4b1e8f2d63",
  "target": "wallet",
  "targetId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
  "tenantId": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
  "reason": "Device reported stolen",
  "frozenBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
  "frozenByRole": "security_admin",
  "frozenByPlatform": false,
  "frozenAt": "2026-10-06T10:42:05.118Z",
  "until": null,
  "active": false,
  "liftedAt": "2026-10-06T15:03:44.902Z",
  "liftedBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
  "liftedByRole": "security_admin",
  "liftReason": "Device recovered"
}
```

`403` Aurea's freeze

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "Only an Aurea administrator lifts this freeze.",
  "details": { "code": "FREEZE_LIFT_PLATFORM_ONLY" }
}
```

---

Web version: https://docs.aureahub.com/#freeze-lift