Assign or Remove Asset Tags

✎ Before you begin

Determine the UUID of any tag you want to use.

Determine the UUID of any asset you want to use.

To assign tags to your assets, use the POST /tags/assets/assignments endpoint.

Request Body Example 1: Add One Tag to Multiple Assets

{
  "action": "add",
  "assets": [
    "1ced39c0-7ffe-45e7-8f7a-30fd3ba0040e",
    "31111367-18f6-46f6-b7b1-f77286ea5aea",
    "0a942ad9-08ae-44d1-b366-3a7764698573",
    "6a3e7e49-97c8-49ef-abc4-2114065dc30a",
    "07a09b3b-4f5b-4321-8c66-baad4856817d"
  ],
  "tags": [
    "f0a2e41d-a69f-4064-b4be-1e745e1c921c"
  ]
}

Request Body Example 2: Add Multiple Tags to One Asset

{
  "action": "add",
  "assets": [
    "1ced39c0-7ffe-45e7-8f7a-30fd3ba0040e"
  ],
  "tags": [
    "f0a2e41d-a69f-4064-b4be-1e745e1c921c",
    "f201a1d4-79d9-4519-9e7c-413fb1a776f9",
    "53f7bb1c-ce2d-4d64-8fff-fc38ff324806"
  ]
}

Request Body Example 3: Add Multiple Tags to Multiple Assets

{
  "action": "add",
  "assets": [
    "1ced39c0-7ffe-45e7-8f7a-30fd3ba0040e",
    "31111367-18f6-46f6-b7b1-f77286ea5aea",
    "0a942ad9-08ae-44d1-b366-3a7764698573",
    "6a3e7e49-97c8-49ef-abc4-2114065dc30a",
    "07a09b3b-4f5b-4321-8c66-baad4856817d"
  ],
  "tags": [
    "f0a2e41d-a69f-4064-b4be-1e745e1c921c",
    "f201a1d4-79d9-4519-9e7c-413fb1a776f9",
    "53f7bb1c-ce2d-4d64-8fff-fc38ff324806"
  ]
}

Request Body Example 4: Remove Asset Tags

{
  "action": "remove",
  "assets": [
    "1ced39c0-7ffe-45e7-8f7a-30fd3ba0040e",
    "31111367-18f6-46f6-b7b1-f77286ea5aea",
    "0a942ad9-08ae-44d1-b366-3a7764698573",
    "6a3e7e49-97c8-49ef-abc4-2114065dc30a",
    "07a09b3b-4f5b-4321-8c66-baad4856817d"
  ],
  "tags": [
    "f0a2e41d-a69f-4064-b4be-1e745e1c921c",
    "f201a1d4-79d9-4519-9e7c-413fb1a776f9",
    "53f7bb1c-ce2d-4d64-8fff-fc38ff324806"
  ]
}