Develop & Integrate
API ReferenceTry in Sandbox

Attach or detach labels to/from UTXOs

patch
https://api.fireblocks.io/v1/utxo_management///labels

Attach or detach labels to/from UTXOs in a vault account. Labels can be used for organizing and filtering UTXOs. Labels are applied additively — labelsToAttach adds to the existing label set and labelsToDetach removes from it. Neither operation replaces the full set. Note: These endpoints are currently in beta and might be subject to changes.
Endpoint Permission: Admin, Non-Signing Admin, Signer, Approver, Editor.

Path Params
string
required

The ID of the vault account

string
required

The ID of the asset

Body Params
utxoIdentifiers
array of objects
required
length between 1 and 200

List of UTXO identifiers to apply label changes to

utxoIdentifiers*
string

Fireblocks transaction ID

string

On-chain transaction hash

integer

Output index

labelsToAttach
array of strings
length between 1 and 5

Labels to attach to the specified UTXOs. At least one of labelsToAttach or labelsToDetach must be provided.

labelsToAttach
labelsToDetach
array of strings
length between 1 and 5

Labels to detach from the specified UTXOs. At least one of labelsToAttach or labelsToDetach must be provided.

labelsToDetach
Headers
string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Responses

Updated about 2 hours ago

Language
URL
LoadingLoading…
Response
Choose an example:
application/json

Updated about 2 hours ago