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
]. Seetag_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.
Feedback
0 comments
Please sign in to leave a comment.