v1

latestOpenAPI 3.1.02026-07-244190162.0 KB

Tagging

Bulk Add Remove Assets

Bulk tag assets within the project.

This method allows you, on an asset-by-asset, basis to add and remove tags which may be applied to them.

As tagging is an asynchronous operation, the API will wait up to 2 seconds for the backend to complete but if it is still not complete in that time, the task_ids contained in the response can be used to continue to check status if the requested operation isn't reflected in later requests.

Even if the response includes complete: true there may still be a slight delay before requests allow for filtering or presentation of the tag on the asset.

post/projects/{project_id}/tags/_bulk_tag_assets

Path parameters

project_idstring required

Request body

asset_tagsobject required

Add/Remove options keyed on the asset you would like to be updated

Example request

{
  "asset_tags": {
    "sample.example.com": {
      "add_tags": [
        "tag1",
        "tag2"
      ],
      "remove_tags": [
        "tag3",
        "tag4"
      ]
    }
  }
}

Response

Successful Response