---
title: Get RBAC Role
url: https://platform.claude.com/docs/en/api/cli/organization/rbac_roles/retrieve
---

# Get RBAC Role

`$ ant organization:rbac-roles retrieve`

**GET** `/v1/organizations/rbac_roles/{rbac_role_id}`

Retrieve an RBAC Role by ID.

The RBAC Roles API is available to Claude Enterprise organizations only.

## Parameters

- `--rbac-role-id: string` (path parameter)

  ID of the RBAC Role.

## Returns

- `rbac_role: object`

  - `type: "rbac_role"`

    Object type.

    For RBAC Roles, this is always `"rbac_role"`.

  - `id: string`

    ID of the RBAC Role.

  - `created_at: string`

    RFC 3339 datetime string indicating when the RBAC Role was created.

    format: date-time

  - `display_name: string`

    Name of the RBAC Role. For a built-in role, this is Anthropic's name for the access that the role grants. Anthropic may change this name, so to keep a lasting reference to a role, store its `id`.

  - `source: RBACRoleSourceBuiltIn or RBACRoleSourceCustom`

    Whether the RBAC Role is built-in or custom. More values of `type` may be added, so do not treat every role that is not `built_in` as `custom`.

    - `rbac_role_source_built_in: object`

      - `type: "built_in"`

        Anthropic provisions the RBAC Role, and the organization's administrators cannot change or delete it.

    - `rbac_role_source_custom: object`

      - `type: "custom"`

        The organization's administrators can change and delete the RBAC Role.

  - `updated_at: string`

    RFC 3339 datetime string indicating when the RBAC Role was last updated.

    format: date-time

## Errors

Any method can also return the general [HTTP errors](https://platform.claude.com/docs/en/api/errors?sdk_languages=cli).

Each code below is the value of `error.details.error_code` in the response body.

- `organization_type_not_supported` (HTTP status 400)

  The endpoint does not support the organization's type. Each endpoint's description says which organization types it supports.

- `parent_organization_required` (HTTP status 400)

  The endpoint serves only organizations that belong to a parent organization, and this organization belongs to none.

- `rbac_role_not_found` (HTTP status 404)

  No RBAC Role with this ID was found.

## Example

```bash
ant organization:rbac-roles retrieve \
  --rbac-role-id rbac_role_id
```

### Response (200)

```json
{
  "id": "rbac_role_016J8xVtKpDq3Wy9ZmN2hR4s",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "Project Editor",
  "source": {
    "type": "built_in"
  },
  "type": "rbac_role",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}
```
