HomeAPI ReferenceToken OperationsUnfreeze Tokens · ERC-3643 / Title-fraction
POST/tokenization/{id}/operations

Unfreeze Tokens · ERC-3643 / Title-fraction

Outcome - An agent unfreezes part of an address's frozen tokens, so the holder can transfer them again. The amount must not exceed the address's frozen tokens. Signer: An agent signs: name one ACTIVE agent of this token in params, as signerWalletAddress or signerWalletId (from Get Token Roles). Exactly one of the two. Templates: erc3643-v1, title-fraction-v1.

Path Parameters

idnumber

Token ID

Body Parameters

operationstringrequired

Always UNFREEZE_PARTIAL_TOKENS for this operation.

paramsobjectrequired

The operation details, including its signer

Show child parameters (4)
addressstringrequired

The holder

amountstringrequired

Amount in whole units, as a string (for example "10.5"), with at most the token's decimals.

signerWalletAddressstringone of the two

Address of the wallet that signs. Give signerWalletAddress or signerWalletId, not both.

signerWalletIdnumberone of the two

ID of that wallet: its wallet of the token (walletId from Get Token Roles). Give signerWalletAddress or signerWalletId, not both.

idempotencyKeystring

Your unique key for this request. Repeating it with the same body returns the first transaction; with a different body it returns 409.

Responses

Response attributes

messagestring

Success message

dataobject

The transaction created

Show child attributes (2)
transactionIdnumber

ID of the transaction (type TOKEN_OPERATION). Follow it with Get Transaction Details or the transaction webhooks: the operation is done when it is COMPLETED.

dataobject

What the operation does, as shown on the transaction everywhere (API and webhooks)

Show child attributes (4)
operationstring

The operation

securityTokenobject

The token

Show child attributes (1)
idnumber

Token ID

movementsarray

Empty: unfreezing moves no tokens

Show child attributes (6)
typestring

MINT (tokens created: has to), BURN (tokens destroyed: has from) or TRANSFER (has from and to)

fromstring

Address the tokens leave. Absent on MINT.

tostring

Address the tokens reach. Absent on BURN.

amountstring

Fungible tokens: amount in whole units (for example "10.5"). Absent for an NFT.

nftTokenIdstring

ERC-721: the NFT that moves. Absent for fungible tokens.

metadataUrlstring

ERC-721 MINT: the metadata URL of the new NFT

stateChangesarray

Freeze changes the operation makes

Show child attributes (3)
typestring

FREEZE_TOKENS, UNFREEZE_TOKENS, FREEZE_ADDRESS or UNFREEZE_ADDRESS

addressstring

The address affected

amountstring

FREEZE_TOKENS and UNFREEZE_TOKENS: amount in whole units

statusnumber

HTTP status code

Was this page helpful?