Freezing Tokens of a User

PUT /tokens/push/{tokenId}/{username}/freeze

Freezes transfers of the specified Hedera token for the given user asynchronously. Only users with the Standard Registry role are allowed to make this request.

Authentication: Bearer token required (Authorization: Bearer <token>)

Permission: Permissions.TOKENS_TOKEN_EXECUTE

---

Request

Path Parameters

Parameter	Type	Required	Description
tokenId	string	Yes	The Hedera token ID (e.g. 0.0.5000001)
username	string	Yes	The username of the target user

---

Response

Success Response

Status: 202 Accepted

{
  "taskId": "63e3e5e8a01b3c001234abcd",
  "expectation": "Freeze token"
}

Poll GET /tasks/{taskId} to retrieve the result.

Error Responses

Status	Description
401 Unauthorized	Missing or invalid token
403 Forbidden	Insufficient permissions
500 Internal Server Error	Unexpected server failure