Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

PATCH: Modify Companies in a Tier

Avatar
Ingrid
Follow
Publication Date – December 10, 2019

⇤ Tiers

https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/companies

Tiers can be used as filters to drive alerts on security ratings or risk vector grades, just like the folder functionality. Use this endpoint to add companies to an existing tier or remove companies from an existing tier.

See tiering user permissions.

Parameters

*Required.

Parameter Description Values 
add_companies
Data		 Companies in your portfolio to add to the tier. [Array] Comma-separated company unique identifiers [entity_guid]. See GET: Portfolio Details. 
remove_companies
Data		 Companies to remove from the tier. [Array] Comma-separated company unique identifiers [entity_guid]. See GET: Portfolio Details. 
tier_guid
Path		 The tier to modify. [String] Tier unique identifier [tier_guid]. See GET: Tiers.

Example Add Request

curl 'https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/companies' -u api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '{"add_companies":["aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee","1111111-2222-3333-4444-555555555555","12345678-1234-1234-1234-123456789012","87654321-4321-4321-4321-210987654321"]}' --compressed

Example Remove Request

curl 'https://api.bitsighttech.com/ratings/v1/tiers/tier_guid/companies' -u api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '{"remove_companies":["aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee","1111111-2222-3333-4444-555555555555","12345678-1234-1234-1234-123456789012","87654321-4321-4321-4321-210987654321"]}' --compressed

Related articles