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:guidusing 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.