Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

PATCH: Edit Access Control Group

Avatar
Ingrid
Follow
Publication Date – April 30, 2020

⇤ Access Groups

https://api.bitsighttech.com/ratings/v1/access-groups/group_guid

Edit an existing Access Control Group.

See Access Control Group user permissions.

Parameters

*Required.

Parameter Description Values 
all_companies
Body		 Allow the selected group to access all companies in the Bitsight inventory. [Boolean] true = Include all companies. 
allow_bundled_companies
Body		 Provide the users in the selected group visibility into companies that are bundled with their group’s subscribed companies (rating bundles), even if they are not directly subscribed to that company. [Boolean] true = Include rating bundles. 
can_set_tier_scope
Body		 Allow this group to set group tiers. [Boolean]
  • true = Use group tiers with tiers that are specific to this group.
  • false = Use the global tier that’s used by all companies in your organization and all users.
 
group_guid
Path		 The group to edit. [String] Group unique identifier [group_guid]. See GET: Access Control Groups. 
is_default
Body		 Assign this as the new default group. New users are automatically added to the default group. [Boolean] true = Assign this group as the default. 
name
Body		 The name to assign to your group. [String] 
subscription_types
Body		 Change the allocated subscriptions per subscription type. [Object] See subscription types.

Example Request

This is an example body of the JSON data sent in the “data” field of a request:

curl 'https://api.bitsighttech.com/ratings/v1/access-groups/group_guid' -u <a" href="/hc/en-us/articles/115014888388-API-Token-Management" class="dynamic" rel="noopener" target="_blank">api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '{"is_default": "boolean","name": "string","subscription_types": {subscription_types}}' --compressed</a">

Errors and Status Codes

See the common errors and status codes.

Code Description
200 – Okay Everything worked as expected.

Related articles