Delete Currency Token by ID
Soft-deletes a currency token: it disappears from every read. Nothing is sent on-chain; a deployed contract stays where it is. The token's node must be the platform root node and inside your API key's node subtree.
Required permission: currency-token:delete
Request
DELETE /v2/admin/currency-tokens/{currency_token_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
currency_token_id | string | path | Required. Currency token ID (24-character hex) |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Example
curl --request DELETE \
--url '{{baseUrl}}/v2/admin/currency-tokens/68fe8c129367fd414b227c7a' \
--header 'Authorization: Bearer <access_token>'
Response
200 OK with an empty body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | Validation failed — see details |
| 404 | 10001 (domain 15) | Currency token not found |
| 400 | 10001 (domain 2) | The token's node was not found |
| 400 | 10005 (domain 2) | The token's node is not the platform root node, or is outside your API key's node subtree. This endpoint answers the refusal with 400 |
| 500 | 10000 | Unexpected server error, including a currency_token_id that is not a 24-character hex ID |
See Errors for the error format and common codes.