Ctrl+K

Create token contract modification request

post/api/stablecoin/v1/issuer/token-contract-modification-requests

Submits a blacklist or freeze request for an address.

Request Body

address string required
Blockchain address
Min length: >= 1 characters
Example: 0xd0898d88e2c08b2a95e19441e412c0a708a8bd43
type string required
Type of modification request
Allowed values: blacklist unblacklist freeze unfreeze
Example: blacklist
assetId string <uuid>required
Asset identifier
Example: 0438163a-d236-4865-978e-02ee7c2285b7
comments string required
Comments about the request
Min length: >= 1 characters
Example: Blacklisting address due to suspicious activity
addressLabel string
Label for the address
Min length: >= 1 characters
Example: Hot Wallet A

200 Response

id string <uuid>required
Unique identifier
Min length: >= 1 characters
Example: 177dc9ed-64a7-4f68-9ba5-8d5b55fe5878
address string required
Address targeted by this request
Min length: >= 1 characters
Example: 0xd0898d88e2c08b2a95e19441e412c0a708a8bd43
type string required
Type of token contract operation
Allowed values: blacklist unblacklist freeze unfreeze
Example: blacklist
status string required
Current lifecycle status of the request
Allowed values: pending approved confirmed rejected failed
Example: pending
enterpriseId string required
Enterprise ID of the requester
Min length: >= 1 characters
Example: 6437d9f07d6a87000613e6c06e4218d3
userId string required
User ID of the requester
Min length: >= 1 characters
Example: 6437d9f07d6a87000613e6c06e4218d3
assetId string <uuid>required
Asset id
Example: 0438163a-d236-4865-978e-02ee7c2285b7
baseAsset string required
Base asset type
Allowed values: gousd usd1 sofid cusd fyusd goqxmp
Example: usd1
chain string required
Blockchain network identifier
Min length: >= 1 characters
Example: eth
createdAt string <date-time>required
Timestamp when the request was created
Example: 2026-03-24T12:00:00.000Z
updatedAt string <date-time>required
Timestamp when the request was last updated
Example: 2026-03-24T12:00:00.000Z
comments string required
Notes about the request
Min length: >= 1 characters
Example: Blacklisting address due to suspicious activity
transactionHash string
Min length: >= 1 characters
confirmedAt string <date-time>
approverId string
Min length: >= 1 characters
rejectorId string
Min length: >= 1 characters

400 Response

401 Response

403 Response

404 Response

500 Response