Skip to main content
POST
/
vault
/
accounts
/
attached_tags
TypeScript
const response: Promise<FireblocksResponse<VaultAccountsTagAttachmentOperationsResponse>> = fireblocks.vaults.attachOrDetachTagsFromVaultAccounts(vaultsApiAttachOrDetachTagsFromVaultAccountsRequest);
{
  "appliedOperations": [
    {
      "vaultAccountId": "1",
      "tagId": "f0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
      "action": "ATTACH"
    }
  ],
  "pendingOperations": [
    {
      "vaultAccountId": "1",
      "tagId": "f0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
      "action": "ATTACH",
      "approvalRequestId": "12345"
    }
  ],
  "rejectedOperations": [
    {
      "vaultAccountId": "1",
      "tagId": "f0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
      "action": "ATTACH",
      "reason": "CAPACITY_EXCEEDED"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Idempotency-Key
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.

Body

application/json
​
vaultAccountIds
string<numeric>[]
required

The IDs of the vault accounts to attach tags to

Required array length: 1 - 100 elements
Example:
["0", "1"]
​
tagIdsToAttach
string<uuid>[]

The IDs of the tags to attach

Required array length: 1 - 20 elements
Example:
[
  "df4c0987-30da-4976-8dcf-bc2dd41ae331",
  "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
]
​
tagIdsToDetach
string<uuid>[]

The IDs of the tags to detach

Required array length: 1 - 20 elements
Example:
[
  "df4c0987-30da-4976-8dcf-bc2dd41ae331",
  "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
]

Response

Tags were attached/detached successfully

​
appliedOperations
object[]

The operations that were applied

​
pendingOperations
object[]

The operations that are pending

​
rejectedOperations
object[]

The operations that were rejected