Pause, unpause, freeze, unfreeze

These endpoints expose the pause/unpause and freeze/unfreeze controls offered by some QRC standards. Pause halts all token activity globally. Freeze halts activity for a single account. Both are privileged operations that always require approval.

Capability matrix

Standard	`pause`	`freeze`
QRC-20	Template-dependent	Template-dependent
QRC-721	Template-dependent	Template-dependent
QRC-1155	Template-dependent	Template-dependent
QRC-1400	Yes (controller)	Yes (per-investor)
QRC-3643	Yes	Yes (per-identity)
QRC-4626	Template-dependent	No
QRC-3525	Template-dependent	No

`POST /v1/tokens/{tokenId}/pause`

Pause all transfers, mints, and burns on the token contract.

Aspect	Detail
Authentication	Bearer API key
Required permissions	`tokens:pause` plus the on-chain `PAUSER` role
Idempotency	`Idempotency-Key` header required
Approval policy	Required
Blockchain effect	Contract call to `pause()`
Webhook events	`token.paused`, `token.operation_failed`

Example response (202)

{
  "operationId": "op_pause_111",
  "tokenId": "token_abc123",
  "operationType": "PAUSE",
  "status": "PENDING_AUTHORIZATION",
  "transactionRequestId": "txreq_006",
  "createdAt": "2026-04-27T10:18:00Z"
}

`POST /v1/tokens/{tokenId}/unpause`

Resume activity. Webhook events: token.unpaused, token.operation_failed. Same request envelope as pause.

`POST /v1/tokens/{tokenId}/freeze`

Request body

{
  "subject": { "type": "address", "address": "0x9a8e5e21…" },
  "reason": "compliance hold — case_2026_0427",
  "idempotencyKey": "freeze-2026-04-27-001"
}

`POST /v1/tokens/{tokenId}/unfreeze`

Release a freeze. Webhook events: token.unfrozen, token.operation_failed.

Errors

Code	Type	Meaning
1703	`TOKEN_NOT_DEPLOYED`	Token has no on-chain `contractAddress`.
1704	`TOKEN_OPERATION_NOT_ALLOWED`	Standard or template does not support pause or freeze.
1708	`TOKEN_ROLE_REQUIRED`	Caller lacks the on-chain `PAUSER` or `FREEZER` role.
1200	`POLICY_DENIED`	Approval policy denied the operation.
1201	`APPROVAL_REQUIRED`	Approval is required and was not yet granted.
1601	`IDEMPOTENCY_CONFLICT`	Same `Idempotency-Key` reused with different body.

Manage token roles Compliance and allowlist

Overview

Health

Tenants

Vaults

Wallets

Transactions

Assets

Tokens

Webhooks

Administration

Pause, unpause, freeze, unfreeze

Capability matrix

`POST /v1/tokens/{tokenId}/pause`

Example response (202)

`POST /v1/tokens/{tokenId}/unpause`

`POST /v1/tokens/{tokenId}/freeze`

Request body

`POST /v1/tokens/{tokenId}/unfreeze`

Errors

​Capability matrix

​POST /v1/tokens/{tokenId}/pause

​Example response (202)

​POST /v1/tokens/{tokenId}/unpause

​POST /v1/tokens/{tokenId}/freeze

​Request body

​POST /v1/tokens/{tokenId}/unfreeze

​Errors

​Related

Capability matrix

`POST /v1/tokens/{tokenId}/pause`

Example response (202)

`POST /v1/tokens/{tokenId}/unpause`

`POST /v1/tokens/{tokenId}/freeze`

Request body

`POST /v1/tokens/{tokenId}/unfreeze`

Errors

Related