PATCH: Tag Asset

https://api.bitsighttech.com/ratings/v1/companies/company_guid/assets/tags

Assign infrastructure tags to assets.

Parameters

* Required.

asset

[Query] Identify the asset to edit.

Value: Asset name.

company_guid

* Required.

[Path] Identify the company to assign tags to.

Value: [String] Company unique identifier [entity_guid]. See GET: Portfolio Details.

tag_guids

[Query] Identify the tag to assign.

Value: [Array] Comma-separated tag unique identifiers [tag_guid]. See tag_details:guid using GET: Assets.

Example Request

cURL:

curl 'https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/assets/tags' -u api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '[{"asset": "Data Center 1","tag_guids": ["ae87bc30-a3ab-45f7-809f-61ec36978685"]}]' --compressed

JSON:

[
  {
    "asset": "Data Center 1,
    "tag_guids": [
      "ae87bc30-a3ab-45f7-809f-61ec36978685"
    ]
  }
]

Example Response

{
  "success": [
    {
      "asset": "ae87bc30-a3ab-45f7-809f-61ec36978685",
      "tag_guids": [
        "ae87bc30-a3ab-45f7-809f-61ec36978685"
      ]
    }
  ]
}

Response Attributes

Fields Description
success

Array

Successfully tagged assets.
  Object Tag details.
 
asset

String

The asset name.
tag_guids

Array [tag_guid]

The unique identifiers of tags.
  • May 2, 2025: Published.
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.