---
title: "Freeze address"
method: POST
path: "/tokens/{id}/freeze"
tags: ["tokens"]
---

# Freeze address

`POST /tokens/{id}/freeze`

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- TokenRoleChangeRequest
  - `role` 'MINTER' | 'BURNER' | 'PAUSER' | 'FREEZER' | 'COMPLIANCE_OPERATOR' | 'OWNER', required
  - `subject` object, required

## Response `202`

Accepted

- TokenOperation
  - `id` string
  - `tokenId` string
  - `operationType` 'CREATE_TOKEN' | 'DEPLOY_TOKEN' | 'MINT' | 'BURN' | 'TRANSFER' | 'GRANT_ROLE' | 'REVOKE_ROLE' | 'PAUSE' | 'UNPAUSE' | 'FREEZE' | 'UNFREEZE' | 'UPDATE_COMPLIANCE' | 'ALLOWLIST_ADD' | 'ALLOWLIST_REMOVE'
  - `status` string — Inherits the transaction state machine.
  - `transactionRequestId` string, nullable
  - `transactionHash` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `data` object

## Other responses

- `default` — Error

---

[API](https://skmtc.net/quantum-chain-pte-ltd/apis/qustody-api.md) · [All operations](https://skmtc.net/quantum-chain-pte-ltd/apis/qustody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quantum-chain-pte-ltd/qustody-api/versions/ecb2cea3c096/schema)