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"
  ]
}