PATCH: Tag Infrastructure

Ingrid

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

Assign infrastructure tags to a company’s infrastructure.

Parameters

* Required.

company_guid

* Required.

[Path] Identify the company to assign tags to.

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

tag_guids

* Required.

[Query] Identify tags to modify.

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

value

* Required.

[Query] Identify the asset to tag.

Value: Asset name.

Example Request

cURL:

curl 'https://api.bitsighttech.com/ratings/v1/companies/66e3842c-11b1-4ca4-9426-0c93609a4ddc/infrastructure/tags' -u api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '[{"value": "12.3.456.789","tag_guids": ["ae87bc30-a3ab-45f7-809f-61ec36978685"]}]' --compressed

JSON:

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

Example Response

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

Response Attributes

Field		Description
errors Array		Tags that could not be assigned.
	value String	The asset name.
	message String	The error message.
success Array		Tags that were successfully assigned.
	value String	The asset name.
	tag_guids Array	Tags [`tag_guid`] that were assigned.

May 2, 2025: Published.