How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Opal Security groups API

Operations related to groups

Opal Security groups API is one of 22 APIs that Opal Security publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Group. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 28 operations across 15 paths, and defines 39 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.opal.dev/v1.

28 operations 15 paths 39 schemas 3 DELETE13 GET4 POST8 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://api.opal.dev/v1
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Opal Security groups API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth).

Paths & Operations 28

Across 15 paths, the API surfaces 28 operations — 3 DELETE, 13 GET, 4 POST, 8 PUT. Each is listed below with its method, path, parameters, and response codes.

groups 28

Operations related to groups

GET
/groups
Get groups
getGroups 6 params → 200
PUT
/groups
Bulk updates a list of groups.
updateGroups body → 200
POST
/groups
Creates an Opal group or [imports a remote group](https://docs.opal.dev/reference/end-system-objects).
createGroup body → 200
GET
/groups/{group_id}
Get group by ID
getGroup 1 param → 200
DELETE
/groups/{group_id}
Deletes a group.
delete_group 1 param → 200
GET
/groups/{group_id}/message-channels
Gets the list of audit and reviewer message channels attached to a group.
get_group_message_channels 1 param → 200
PUT
/groups/{group_id}/message-channels
Sets the list of audit message channels attached to a group.
set_group_message_channels 1 param body → 200
GET
/groups/{group_id}/on-call-schedules
Gets the list of on call schedules attached to a group.
get_group_on_call_schedules 1 param → 200
PUT
/groups/{group_id}/on-call-schedules
Sets the list of on call schedules attached to a group.
set_group_on_call_schedules 1 param body → 200
GET
/groups/{group_id}/resources
Gets the list of resources that the group gives access to.
get_group_resources 1 param → 200
PUT
/groups/{group_id}/resources
Sets the list of resources that the group gives access to.
set_group_resources 1 param body → 200
GET
/groups/{group_id}/containing-groups
Get nested groups
get_group_containing_groups 2 params → 200
POST
/groups/{group_id}/containing-groups
Creates a new containing group.
add_group_containing_group 1 param body → 200
GET
/groups/{group_id}/containing-groups/{containing_group_id}
Get nested group by ID
get_group_containing_group 2 params → 200
DELETE
/groups/{group_id}/containing-groups/{containing_group_id}
Removes a containing group from a group.
remove_group_containing_group 3 params → 204
POST
/groups/{group_id}/resources/{resource_id}
Adds a resource to a group.
add_group_resource 3 params body → 200
GET
/groups/{group_id}/visibility
Gets the visibility of this group.
get_group_visibility 1 param → 200
PUT
/groups/{group_id}/visibility
Sets the visibility of this group.
set_group_visibility 1 param body → 200
GET
/groups/{group_id}/reviewersdeprecated
Gets the list of owner IDs of the reviewers for a group.
get_group_reviewers 1 param → 200
PUT
/groups/{group_id}/reviewersdeprecated
Sets the list of reviewers for a group.
set_group_reviewers 1 param body → 200
GET
/groups/{group_id}/reviewer-stagesdeprecated
Gets the list of reviewer stages for a group.
get_group_reviewer_stages 1 param → 200
PUT
/groups/{group_id}/reviewer-stagesdeprecated
Sets the list of reviewer stages for a group.
set_group_reviewer_stages 1 param body → 200
GET
/groups/{group_id}/tags
Returns all tags applied to the group.
get_group_tags 1 param → 200
GET
/groups/{group_id}/users
Gets the list of users for this group.
get_group_users 3 params → 200
PUT
/groups/{group_id}/users/{user_id}
Updates a user's access level or duration in this group.
update_group_user 2 params body → 200
POST
/groups/{group_id}/users/{user_id}
Adds a user to this group.
add_group_user 4 params body → 200
DELETE
/groups/{group_id}/users/{user_id}
Removes a user's access from this group.
delete_group_user 3 params → 200
GET
/groups/users/{user_id}
Returns all groups that the user is a member of.
get_user_groups 3 params → 200

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are GroupRemoteInfo (30 properties), Group (29 properties), UpdateGroupInfo (21 properties), RequestConfiguration (11 properties). Each schema is shown below with its type and property counts.

ResourceAccessLevel
object
Access Level Object Description The AccessLevel object is used to represent the level of access that a principal has. The "default" access level is a AccessLev…
2 properties 2 required
OnCallScheduleProviderEnum
string
The third party provider of the on call schedule.
CreateGroupInfo
object
CreateGroupInfo Object Description The CreateGroupInfo object is used to store creation info for a group. Usage Example Use in the POST Groups endpoint.
9 properties 3 required
VisibilityInfo
object
Visibility infomation of an entity.
2 properties 1 required
RequestConfiguration
object
Request Configuration Object Description The RequestConfiguration object is used to represent a request configuration. Usage Example Returned from the GET Requ…
11 properties 6 required
GroupUserList
object
3 properties
Tag
object
Tag Object Description The Tag object is used to represent a tag. Usage Example Get tags from the GET Tag endpoint.
6 properties 1 required
UpdateGroupInfoList
object
1 property 1 required
MessageChannelIDList
object
A list of message channel IDs.
1 property 1 required
VisibilityTypeEnum
string
The visibility level of the entity.
Group
object
Group Object Description The Group object is used to represent a group. Usage Example Update from the UPDATE Groups endpoint.
29 properties 1 required
GroupAccessLevel
object
Access Level Object Description The GroupAccessLevel object is used to represent the level of access that a user has to a group or a group has to a group. The…
2 properties 2 required
SyncTask
object
Represents a sync task that has been completed, either successfully or with errors.
2 properties 2 required
UpdateGroupResourcesInfo
object
1 property 1 required
OnCallScheduleList
object
1 property 1 required
GroupUser
object
Group Access User Object Description The GroupAccessUser object is used to represent a user with access to a group. Usage Example Fetch from the LIST GroupUser…
9 properties 6 required
GroupResourceList
object
1 property 1 required
GroupContainingGroup
object
GroupContainingGroup Object Description The GroupContainingGroup object is used to represent a relationship between a group and a group.
3 properties 1 required
MessageChannelProviderEnum
string
The third party provider of the message channel.
ReviewerIDList
object
A list of reviewer IDs.
1 property 1 required
OnCallScheduleIDList
object
A list of on call schedule Opal UUIDs. To get the matching remote IDs, use the /on-call-schedules endpoints.
1 property 1 required
GroupRemoteInfo
object
Information that defines the remote group. This replaces the deprecated remoteid and metadata fields. If remoteinfo is provided, a group will be imported into…
30 properties
GroupResource
object
GroupResource Object Description The GroupResource object is used to represent a relationship between a group and a resource.
6 properties 3 required
MessageChannelList
object
1 property 1 required
Condition
object
Condition Object Description The Condition object is used to represent a condition. Usage Example Used to match request configurations to users in RequestConfi…
2 properties
ResourceWithAccessLevel
object
Information about a resource and corresponding access level
2 properties 1 required
OnCallSchedule
object
OnCallSchedule Object Description The OnCallSchedule object is used to represent an on call schedule. Usage Example Update a groups on call schedule from the U…
4 properties 1 required
PropagationStatusEnum
string
The status of whether the user has been synced to the group or resource in the remote system.
UpdateGroupInfo
object
UpdateGroupInfo Object Description The UpdateGroupInfo object is used as an input to the UpdateGroup API.
21 properties 1 required
ReviewerStage
object
A reviewer stage.
5 properties 4 required
ReviewerStageList
object
1 property 1 required
GroupContainingGroupList
object
1 property 1 required
CreateRequestConfigurationInfoList
object
CreateRequestConfigurationInfoList Object Description The CreateRequestConfigurationInfoList object is used as an input to the CreateRequestConfigurations API.…
1 property 1 required
GroupTypeEnum
string
The type of the group.
PaginatedGroupsList
object
3 properties 1 required
RiskSensitivityEnum
string
Indicates the level of potential impact misuse or unauthorized access may incur.
MessageChannel
object
MessageChannel Object Description The MessageChannel object is used to represent a message channel. Usage Example Update a groups message channel from the UPDA…
5 properties 1 required
TagsList
object
1 property 1 required
PropagationStatus
object
The state of whether the push action was propagated to the remote system. If this is null, the access was synced from the remote system.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opal-security-groups-api-openapi.yml Raw ↑

Other APIs Opal Security publishes across the network.

Opal Security access-rules API
Opal Security apps API
Opal Security bundles API
Opal Security configuration-templates API
Opal Security delegations API
Opal Security event-streams API
Opal Security events API
Opal Security group-bindings API
Opal Security idp-group-mappings API
Opal Security message-channels API
Opal Security non-human-identities API
Opal Security on-call-schedules API
Where this information came from

This is an independent, third-party profile of Opal Security groups API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.