Get RBAC Group
api/admin/rbac_groups/retrieve
History
api/admin/rbac_groups/retrieve Changed · +1 / -9 lines
## Headers
Retrieve an RBAC Group by ID. -The RBAC Groups API is in beta and available to Claude Enterprise organizations only. Requests must send the `ce-user-management-2026-07-13` value in the `anthropic-beta` header. +The RBAC Groups API is available to Claude Enterprise organizations only. ## Path parameters
- `group_id: string` ID of the RBAC Group. - -## Headers - -- `"anthropic-beta": optional array of string` - - Optional header to specify the beta version(s) you want to use. - - To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta. ## Returns
api/admin/rbac_groups/retrieve Changed · +14 / -15 lines
# Get RBAC Group ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Get RBAC Group ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
---- -title: Get RBAC Group -url: https://platform.claude.com/docs/en/api/admin/rbac_groups/retrieve ---- +# Get RBAC Group -## Get RBAC Group +**GET** `/v1/organizations/rbac_groups/{group_id}` -**get** `/v1/organizations/rbac_groups/{group_id}` - Retrieve an RBAC Group by ID. The RBAC Groups API is in beta and available to Claude Enterprise organizations only. Requests must send the `ce-user-management-2026-07-13` value in the `anthropic-beta` header. -### Path Parameters +## Path parameters - `group_id: string` ID of the RBAC Group. -### Header Parameters +## Headers - `"anthropic-beta": optional array of string`
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta. -### Returns +## Returns -- `RbacGroup object { id, created_at, name, 4 more }` +- `RbacGroup object` - `id: string`
RFC 3339 timestamp of when the RBAC Group was created. + format: date-time + - `name: string` Name of the RBAC Group. Not uniqueness-enforced.
For RBAC Groups, this is always `"rbac_group"`. - - `"rbac_group"` + default: rbac_group - `updated_at: string` RFC 3339 timestamp of when the RBAC Group was last updated. -### Example + format: date-time -```http +## Example + +```bash curl https://api.anthropic.com/v1/organizations/rbac_groups/$GROUP_ID \ -H 'anthropic-version: 2023-06-01' \ -H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN" ``` -#### Response +### Response (200) ```json {
api/admin/rbac_groups/retrieve First recorded · 90 lines, first recorded
## Get RBAC Group ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Get RBAC Group
url: https://platform.claude.com/docs/en/api/admin/rbac_groups/retrieve
---
## Get RBAC Group
**get** `/v1/organizations/rbac_groups/{group_id}`
Retrieve an RBAC Group by ID.
The RBAC Groups API is in beta and available to Claude Enterprise organizations only. Requests must send the `ce-user-management-2026-07-13` value in the `anthropic-beta` header.
### Path Parameters
- `group_id: string`
ID of the RBAC Group.
### Header Parameters
- `"anthropic-beta": optional array of string`
Optional header to specify the beta version(s) you want to use.
To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.
### Returns
- `RbacGroup object { id, created_at, name, 4 more }`
- `id: string`
ID of the RBAC Group.
- `created_at: string`
RFC 3339 timestamp of when the RBAC Group was created.
- `name: string`
Name of the RBAC Group. Not uniqueness-enforced.
- `roles: array of string or null`
RBAC Role IDs attached to this RBAC Group. Role attachment is managed in the admin settings and is read-only on this API. `null` means role data was temporarily unavailable — retry to distinguish from an empty list.
- `source_type: "direct" or "scim"`
How the RBAC Group was created: `"direct"` for groups created directly (for example, in the organization's admin settings), `"scim"` for groups provisioned by the identity provider.
- `"direct"`
- `"scim"`
- `type: "rbac_group"`
Object type.
For RBAC Groups, this is always `"rbac_group"`.
- `"rbac_group"`
- `updated_at: string`
RFC 3339 timestamp of when the RBAC Group was last updated.
### Example
```http
curl https://api.anthropic.com/v1/organizations/rbac_groups/$GROUP_ID \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
```
#### Response
```json
{
"id": "rbac_group_012rppKaSVsmTo6NqRDXQXNF",
"created_at": "2024-10-30T23:58:27.427722Z",
"name": "Engineering",
"roles": [
"rbac_role_016J8xVtKpDq3Wy9ZmN2hR4s"
],
"source_type": "direct",
"type": "rbac_group",
"updated_at": "2024-10-30T23:58:27.427722Z"
}
```