https://api.bitsighttech.com/ratings/v1/companies/company_guid/tags/bulk
Create, modify, or delete infrastructure tags.
Parameters
* Required.
- add
-
* Required.
[Query] Identify the tags to assign.
Value: [Array]
- company_guid
-
* Required.
[Path] Identify the company to assign tags to.
Value: [String] Company unique identifier [
entity_guid
]. See GET: Portfolio Details. - is_public
-
* Required.
[Query] Identify the tag’s visibility.
Value: [Boolean]
-
true
= The tag is public. -
false
= The tag is private.
-
- name
-
* Required.
[Query] Identify the tag by name.
Value: [String] The tag name.
Example Request
cURL:
curl -H "Content-Type: application/json" -X POST -i https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/tags/bulk -u api_token: -d '{"add": [{"name": "Data Center 1","is_public": true}]}'
JSON:
{ "add": [ { "name": "Data Center 1", "is_public": true } ] }
Example Response
{ "not_added": [], "added": [ { "is_public": true, "guid": "ae87bc30-a3ab-45f7-809f-61ec36978685", "name": "Data Center 1" } ] }
Response Attributes
Fields | Description | ||
---|---|---|---|
not_added Array |
Tags that could not be added. | ||
Object | Tag details. | ||
is_public Boolean |
The tag’s visibility. | ||
guid String [ |
The tag unique identifier. | ||
name String |
The tag name. | ||
added Array |
Tags that were successfully added. | ||
Object | Tag details. | ||
is_public Boolean |
The tag’s visibility. | ||
guid String [ |
The tag unique identifier. | ||
name String |
The tag name. |
- May 2, 2025: Published.
Feedback
0 comments
Please sign in to leave a comment.