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
]. Seetag_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 [ |
The unique identifiers of tags. |
- May 2, 2025: Published.
Feedback
0 comments
Please sign in to leave a comment.