Repository Public
1---2title: User management3url: https://platform.claude.com/docs/en/manage-claude/user-management4description: "Manage the people in your Claude Enterprise organization with the Admin API: list members and change roles, send and withdraw invites, manage groups, and read custom roles."5---67This page covers managing the people in your **Claude Enterprise** (claude.ai) organization programmatically, using the [Admin API](https://platform.claude.com/docs/en/api/admin): list members and look them up by email address, change a member's role, remove members, send and withdraw invites, manage your enterprise's groups and their membership, and read your organization's custom roles. For Claude Console (Claude Platform) organizations, see the [Admin API guide for Claude Console](https://platform.claude.com/docs/en/manage-claude/admin-api).89<Note>10 Group and custom-role requests don't require the `anthropic-beta: ce-user-management-2026-07-13` [beta header](https://platform.claude.com/docs/en/api/beta-headers). Requests that still send it are accepted and behave identically.11</Note>1213## Which endpoints can your organization use?1415The Admin API is a single set of endpoints under `https://api.anthropic.com/v1/organizations/`. Claude Console and Claude Enterprise organizations authenticate with [different keys](https://platform.claude.com/docs/en/manage-claude/admin-api-keys) and each have access to a different subset of the endpoints:1617| Endpoints | Claude Console (Claude Platform) | Claude Enterprise (claude.ai) |18| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |19| [Members](https://platform.claude.com/docs/en/manage-claude/user-management#members) and [invites](https://platform.claude.com/docs/en/manage-claude/user-management#invites) | Available; see the [Admin API guide](https://platform.claude.com/docs/en/manage-claude/admin-api) | Available (this page) |20| [Groups](https://platform.claude.com/docs/en/manage-claude/user-management#groups) | Not available | Available (this page) |21| [Custom roles](https://platform.claude.com/docs/en/manage-claude/user-management#custom-roles) | Not available | Available, read-only (this page) |22| [Spend limits](https://platform.claude.com/docs/en/manage-claude/spend-limits-api) | Not available | Available |23| [Workspaces](https://platform.claude.com/docs/en/manage-claude/workspaces), [API keys](https://platform.claude.com/docs/en/manage-claude/admin-api#api-keys), [usage and cost reports](https://platform.claude.com/docs/en/manage-claude/usage-cost-api), [rate limits](https://platform.claude.com/docs/en/manage-claude/rate-limits-api), and the other endpoints in the [Admin API guide](https://platform.claude.com/docs/en/manage-claude/admin-api) | Available | Not available |2425Members and invites are the same endpoints for both organization types; this page documents their Claude Enterprise behavior, including the Claude Enterprise [organization roles](https://platform.claude.com/docs/en/manage-claude/user-management#organization-roles). The group and custom-role endpoints exist only for Claude Enterprise.2627<Check>28 **Scoped Admin API key required**2930 These endpoints require an Admin API key with the `read:members` scope (member and invite `GET` endpoints, and all custom-role endpoints; there is no separate role scope), the `write:members` scope (member and invite `POST` and `DELETE` endpoints), the `read:rbac_groups` scope (group `GET` endpoints), or the `write:rbac_groups` scope (group `POST` and `DELETE` endpoints). A key carrying the `read:org_audit` scope (a read-only scope for security-audit integrations) can also call every `GET` endpoint on this page and the [Compliance API](https://platform.claude.com/docs/en/manage-claude/compliance-api) read endpoints. See [Create an Admin API key](https://platform.claude.com/docs/en/manage-claude/admin-api-keys#create-a-key-for-a-claude-enterprise-organization) for where your primary owner creates one and which scopes to select. Pass the key in the `x-api-key` header on every request, together with the [`anthropic-version`](https://platform.claude.com/docs/en/api/versioning) header.31</Check>3233## Overview3435This page covers five resources:3637| Resource | Endpoints | Use for |38| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |39| **Members** | `GET /v1/organizations/users` `GET /v1/organizations/users/{user_id}` `POST /v1/organizations/users/{user_id}` `DELETE /v1/organizations/users/{user_id}` | List the organization's members or look one up by email; change a member's role; remove a member. |40| **Invites** | `POST /v1/organizations/invites` `GET /v1/organizations/invites` `GET /v1/organizations/invites/{invite_id}` `DELETE /v1/organizations/invites/{invite_id}` | Invite a person to the organization, track the invitation's status, and withdraw it before it is accepted. |41| **Groups** | `GET /v1/organizations/rbac_groups` `GET /v1/organizations/rbac_groups/{group_id}` `POST /v1/organizations/rbac_groups` `POST /v1/organizations/rbac_groups/{group_id}` `DELETE /v1/organizations/rbac_groups/{group_id}` | Read your enterprise's groups and the custom roles attached to each; create, rename, and delete groups. |42| **Group members** | `GET /v1/organizations/rbac_groups/{group_id}/members` `POST /v1/organizations/rbac_groups/{group_id}/members` `DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id}` | Read a group's members; add and remove members. |43| **Custom roles** | `GET /v1/organizations/rbac_roles` `GET /v1/organizations/rbac_roles/{role_id}` `GET /v1/organizations/rbac_roles/{role_id}/permissions` | Read your organization's custom roles and the permissions each role grants. |4445Custom roles and their group attachments are managed in [claude.ai organization settings](https://claude.ai/admin-settings); the API reads them but cannot change them.4647## Quick start4849List the organization's members, newest first:5051```bash cURL52curl "https://api.anthropic.com/v1/organizations/users?limit=20" \53 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \54 -H "anthropic-version: 2023-06-01"55```5657```json58{59 "data": [60 {61 "type": "user",62 "id": "user_01AbCdEfGhIjKlMnOpQrSt",63 "email": "jane@example.com",64 "name": "Jane Smith",65 "role": "user",66 "added_at": "2026-06-12T09:14:03Z"67 }68 ],69 "has_more": false,70 "first_id": "user_01AbCdEfGhIjKlMnOpQrSt",71 "last_id": "user_01AbCdEfGhIjKlMnOpQrSt"72}73```7475## Key concepts7677### Organization roles7879Every member has exactly one organization role. Reads return the member's role as one of five values:8081| Role | Meaning |82| ------------------ | ----------------------------------------------------------------------------------------- |83| `user` | A standard member. |84| `managed` | A member whose permissions are granted through the custom roles attached to their groups. |85| `owner` | An organization owner. |86| `membership_admin` | A member who can manage the organization's members. |87| `primary_owner` | The organization's primary owner. There is exactly one. |8889The API can assign only the `user` and `managed` roles, on invite creation and on role updates. The administrative roles (`owner`, `membership_admin`, and `primary_owner`) are assigned in claude.ai organization settings, and members holding them cannot be modified or removed through this API.9091### Members and invites9293A person becomes a member by accepting an invite (or through your organization's single sign-on, where configured). Creating an invite sends an invitation email; the invite then reads as `pending` until the recipient accepts (`accepted`) or its server-assigned `expires_at` passes (`expired`). Only a `pending` invite can be withdrawn. To change a pending invitation's email address or role, withdraw it and create a new one.9495If your organization's plan draws members from a finite pool of purchased seats, a pending invite consumes a seat. The create-invite endpoint does not take a seat or tier parameter: the seat is assigned automatically from the lowest tier that has availability. Creating an invite when no seat is free fails with a 400 error rather than purchasing a seat. Withdrawing the invite, letting it expire, or removing the member later returns the seat to the pool.9697### Groups and roles9899Groups connect members to custom roles (role-based access control, the `rbac` in the endpoint paths and scope names). Groups are owned by your enterprise as a whole (the parent organization together with every organization under it) rather than by a single organization, so the group scopes (`read:rbac_groups` and `write:rbac_groups`) require a key created for all linked organizations. Each group carries a `source_type`: `direct` for groups created in claude.ai, `scim` for groups provisioned by your identity provider. A group's `roles` field lists the IDs of the custom roles attached to it; resolve them to names and permissions with the [custom role endpoints](https://platform.claude.com/docs/en/manage-claude/user-management#custom-roles), noting that the role catalog is per-organization while groups are enterprise-wide, so fetching a role that belongs to a different organization of your enterprise returns 404 for your key. The field is `null` (rather than `[]`) when role data was temporarily unavailable, so retry to distinguish a degraded read from a group with no roles.100101## Versioning102103Send the `anthropic-version` header on every request; see [API versions](https://platform.claude.com/docs/en/api/versioning) for the available versions.104105## Rate limits106107Admin API endpoints share a per-organization limit of **100 requests per minute**; invite creation has its own limit of **1,200 requests per hour** instead. Requests over a limit return **429 Too Many Requests**.108109## Pagination110111Member and invite lists use ID-based pagination: pass `limit` (default 20, max 1000) plus at most one of `before_id` or `after_id`, and page using the `first_id` and `last_id` fields of each response until `has_more` is `false`. Group and custom-role lists use an **opaque cursor** instead: the response's `next_page` value is passed unchanged as the `page` parameter on the next request, until `next_page` is `null`.112113## Error responses114115Error responses follow the standard shape documented in [Errors](https://platform.claude.com/docs/en/api/errors).116117## Members118119### List members120121`GET /v1/organizations/users` returns the organization's members, most recently added first. Filter by `email` to look up a specific member; the match is case-insensitive and tolerates common variants of the same address (for example, `jane+hiring@example.com` matches `jane@example.com`). Requires the `read:members` scope.122123For complete parameter details and response schemas, see [List users](https://platform.claude.com/docs/en/api/admin/users/list) in the API reference.124125```bash cURL126curl "https://api.anthropic.com/v1/organizations/users?email=jane@example.com" \127 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \128 -H "anthropic-version: 2023-06-01"129```130131### Get a member132133`GET /v1/organizations/users/{user_id}` returns one member by ID. Requires the `read:members` scope.134135For complete parameter details and response schemas, see [Get user](https://platform.claude.com/docs/en/api/admin/users/retrieve) in the API reference.136137```bash cURL138curl "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \139 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \140 -H "anthropic-version: 2023-06-01"141```142143### Change a member's role144145`POST /v1/organizations/users/{user_id}` sets the member's role to `user` or `managed`. Members holding an administrative role (`owner`, `membership_admin`, or `primary_owner`) cannot be changed through this endpoint, and administrative roles cannot be assigned; both return 400 and are managed in claude.ai organization settings. If your organization's identity provider manages roles (advanced SSO or advanced SCIM provisioning), role updates return 400. Requires the `write:members` scope.146147For complete parameter details and response schemas, see [Update user](https://platform.claude.com/docs/en/api/admin/users/update) in the API reference.148149```bash cURL150curl -X POST "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \151 -H "content-type: application/json" \152 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \153 -H "anthropic-version: 2023-06-01" \154 -d '{"role": "managed"}'155```156157### Remove a member158159`DELETE /v1/organizations/users/{user_id}` removes the member from the organization, returning any purchased seat they occupied to the organization's pool. Members holding an administrative role cannot be removed through this endpoint, and if your identity provider manages membership (SCIM), removals return 400. Requires the `write:members` scope.160161For complete parameter details and response schemas, see [Remove user](https://platform.claude.com/docs/en/api/admin/users/delete) in the API reference.162163```bash cURL164curl -X DELETE "https://api.anthropic.com/v1/organizations/users/user_01AbCdEfGhIjKlMnOpQrSt" \165 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \166 -H "anthropic-version: 2023-06-01"167```168169```json170{171 "type": "user_deleted",172 "id": "user_01AbCdEfGhIjKlMnOpQrSt"173}174```175176## Invites177178### Create an invite179180`POST /v1/organizations/invites` sends an invitation email and returns the invite with a server-assigned `expires_at`. `role` must be `user` or `managed`. If a pending invite already exists for the email address, or the address already belongs to a member, the request returns 400 naming the existing resource. Organizations whose identity provider provisions users automatically (JIT or SCIM) cannot create invites through the API. Requires the `write:members` scope.181182On plans that draw members from a finite seat pool, the invite automatically takes a seat from the lowest tier that has availability; the API does not take a tier parameter. If no seat is free, the request fails with a 400 error rather than purchasing a seat. Add seats through the organization's plan management and retry.183184The optional `rbac_group_ids` field lists groups (by `rbac_group_`-prefixed ID) to assign to the member when they accept. Passing a non-empty `rbac_group_ids` additionally requires the key to carry the `write:rbac_groups` scope, because group assignment can grant the permissions attached to the group's roles.185186For complete parameter details and response schemas, see [Create invite](https://platform.claude.com/docs/en/api/admin/invites/create) in the API reference.187188```bash cURL189curl -X POST "https://api.anthropic.com/v1/organizations/invites" \190 -H "content-type: application/json" \191 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \192 -H "anthropic-version: 2023-06-01" \193 -d '{194 "email": "newhire@example.com",195 "role": "managed",196 "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]197 }'198```199200```json201{202 "type": "invite",203 "id": "invite_01QrStUvWxYzAbCdEfGhIj",204 "email": "newhire@example.com",205 "role": "managed",206 "invited_at": "2026-07-06T16:20:11Z",207 "expires_at": "2026-07-27T16:20:11Z",208 "accepted_at": null,209 "status": "pending",210 "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]211}212```213214### List invites215216`GET /v1/organizations/invites` returns the organization's invites, most recent first, across the `pending`, `accepted`, and `expired` states; there is no status filter. Requires the `read:members` scope.217218For complete parameter details and response schemas, see [List invites](https://platform.claude.com/docs/en/api/admin/invites/list) in the API reference.219220```bash cURL221curl "https://api.anthropic.com/v1/organizations/invites?limit=20" \222 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \223 -H "anthropic-version: 2023-06-01"224```225226### Get an invite227228`GET /v1/organizations/invites/{invite_id}` returns one invite by ID. Requires the `read:members` scope.229230For complete parameter details and response schemas, see [Get invite](https://platform.claude.com/docs/en/api/admin/invites/retrieve) in the API reference.231232```bash cURL233curl "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \234 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \235 -H "anthropic-version: 2023-06-01"236```237238### Withdraw an invite239240`DELETE /v1/organizations/invites/{invite_id}` withdraws a `pending` invite, deactivating the link in the invitation email. Withdrawing an `accepted` invite returns 400 (remove the member instead); withdrawing an `expired` invite returns 400. Requires the `write:members` scope.241242For complete parameter details and response schemas, see [Delete invite](https://platform.claude.com/docs/en/api/admin/invites/delete) in the API reference.243244```bash cURL245curl -X DELETE "https://api.anthropic.com/v1/organizations/invites/invite_01QrStUvWxYzAbCdEfGhIj" \246 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \247 -H "anthropic-version: 2023-06-01"248```249250## Groups251252Groups your enterprise creates directly, in [claude.ai organization settings](https://claude.ai/admin-settings) or through this API (`source_type: "direct"`), support every endpoint in this section. Groups provisioned by your identity provider (`source_type: "scim"`) can be read but not modified: renaming or deleting a SCIM group, or changing its membership, returns 400, because your identity provider owns it.253254### List groups255256`GET /v1/organizations/rbac_groups` returns your enterprise's groups, including identity-provider-managed (`scim`) groups. Requires the `read:rbac_groups` scope.257258For complete parameter details and response schemas, see [List groups](https://platform.claude.com/docs/en/api/admin/rbac_groups/list) in the API reference.259260```bash cURL261curl "https://api.anthropic.com/v1/organizations/rbac_groups?limit=20" \262 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \263 -H "anthropic-version: 2023-06-01"264```265266```json267{268 "data": [269 {270 "type": "rbac_group",271 "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",272 "name": "Engineering",273 "source_type": "direct",274 "roles": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],275 "created_at": "2026-03-18T10:01:42Z",276 "updated_at": "2026-05-02T08:55:09Z"277 }278 ],279 "has_more": false,280 "next_page": null281}282```283284### Get a group285286`GET /v1/organizations/rbac_groups/{group_id}` returns one group by ID. Requires the `read:rbac_groups` scope.287288For complete parameter details and response schemas, see [Get group](https://platform.claude.com/docs/en/api/admin/rbac_groups/retrieve) in the API reference.289290```bash cURL291curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \292 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \293 -H "anthropic-version: 2023-06-01"294```295296### Create a group297298`POST /v1/organizations/rbac_groups` creates a group with the given `name` (1–255 characters) and no roles or members. Requires the `write:rbac_groups` scope.299300For complete parameter details and response schemas, see [Create group](https://platform.claude.com/docs/en/api/admin/rbac_groups/create) in the API reference.301302```bash cURL303curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups" \304 -H "content-type: application/json" \305 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \306 -H "anthropic-version: 2023-06-01" \307 -d '{"name": "Engineering"}'308```309310```json311{312 "type": "rbac_group",313 "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",314 "name": "Engineering",315 "source_type": "direct",316 "roles": [],317 "created_at": "2026-07-09T18:00:00Z",318 "updated_at": "2026-07-09T18:00:00Z"319}320```321322### Rename a group323324`POST /v1/organizations/rbac_groups/{group_id}` updates the group. `name` is the only field this endpoint can change. Requires the `write:rbac_groups` scope.325326For complete parameter details and response schemas, see [Update group](https://platform.claude.com/docs/en/api/admin/rbac_groups/update) in the API reference.327328```bash cURL329curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \330 -H "content-type: application/json" \331 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \332 -H "anthropic-version: 2023-06-01" \333 -d '{"name": "Platform Engineering"}'334```335336### Delete a group337338`DELETE /v1/organizations/rbac_groups/{group_id}` deletes the group. Its members remain members of their organizations, but they lose the permissions of its attached roles, and a group [spend limit](https://platform.claude.com/docs/en/manage-claude/spend-limits-api), if one existed, stops applying to them. Requires the `write:rbac_groups` scope.339340For complete parameter details and response schemas, see [Delete group](https://platform.claude.com/docs/en/api/admin/rbac_groups/delete) in the API reference.341342```bash cURL343curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn" \344 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \345 -H "anthropic-version: 2023-06-01"346```347348```json349{350 "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",351 "type": "rbac_group_deleted"352}353```354355### List a group's members356357`GET /v1/organizations/rbac_groups/{group_id}/members` returns the group's members (each with their `user_id` and email), oldest first. Only current members of your enterprise's organizations are returned, so a page might contain fewer than `limit` entries while `has_more` is `true`. Requires the `read:rbac_groups` scope.358359For complete parameter details and response schemas, see [List group members](https://platform.claude.com/docs/en/api/admin/rbac_groups/members/list) in the API reference.360361```bash cURL362curl "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members?limit=100" \363 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \364 -H "anthropic-version: 2023-06-01"365```366367```json368{369 "data": [370 {371 "type": "rbac_group_member",372 "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",373 "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",374 "email": "jane@example.com",375 "created_at": "2026-04-07T12:30:00Z"376 }377 ],378 "has_more": false,379 "next_page": null380}381```382383### Add a member to a group384385`POST /v1/organizations/rbac_groups/{group_id}/members` adds an organization member to the group by `user_id`. The user must already be a member of one of your enterprise's organizations (the request returns 404 otherwise), and adding someone who is already in the group returns 400. For `scim` groups, membership is managed in your identity provider and this request returns 400. To assign groups to a person who has not joined yet, use `rbac_group_ids` on [invite creation](https://platform.claude.com/docs/en/manage-claude/user-management#create-an-invite) instead. Requires the `write:rbac_groups` scope.386387For complete parameter details and response schemas, see [Add group member](https://platform.claude.com/docs/en/api/admin/rbac_groups/members/create) in the API reference.388389```bash cURL390curl -X POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \391 -H "content-type: application/json" \392 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \393 -H "anthropic-version: 2023-06-01" \394 -d '{"user_id": "user_01AbCdEfGhIjKlMnOpQrSt"}'395```396397```json398{399 "type": "rbac_group_member",400 "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",401 "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",402 "email": "jane@example.com",403 "created_at": "2026-07-09T18:00:00Z"404}405```406407### Remove a member from a group408409`DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id}` removes the member from the group; they remain a member of their organization. The request returns 404 if the user is not a member of the group, and 400 for `scim` groups, whose membership is managed in your identity provider. Requires the `write:rbac_groups` scope.410411For complete parameter details and response schemas, see [Remove group member](https://platform.claude.com/docs/en/api/admin/rbac_groups/members/delete) in the API reference.412413```bash cURL414curl -X DELETE "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members/user_01AbCdEfGhIjKlMnOpQrSt" \415 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \416 -H "anthropic-version: 2023-06-01"417```418419```json420{421 "group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",422 "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",423 "type": "rbac_group_member_deleted"424}425```426427## Custom roles428429Custom roles are read-only through the API: these endpoints catalog your organization's custom roles (defined in [claude.ai organization settings](https://claude.ai/admin-settings) or provisioned by Anthropic) and the permissions each role grants. Custom-role reads use the `read:members` scope (there is no separate role scope) and work with an organization-level key: unlike the group endpoints, they do not require a key created for all linked organizations, and the catalog returned is your organization's own.430431### List roles432433`GET /v1/organizations/rbac_roles` returns your organization's custom roles. Requires the `read:members` scope.434435For complete parameter details and response schemas, see [List roles](https://platform.claude.com/docs/en/api/admin/rbac_roles/list) in the API reference.436437```bash cURL438curl "https://api.anthropic.com/v1/organizations/rbac_roles?limit=20" \439 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \440 -H "anthropic-version: 2023-06-01"441```442443```json444{445 "data": [446 {447 "type": "rbac_role",448 "id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",449 "name": "Engineering base",450 "created_at": "2026-03-18T10:01:42Z",451 "updated_at": "2026-05-02T08:55:09Z"452 }453 ],454 "has_more": false,455 "next_page": null456}457```458459### Get a role460461`GET /v1/organizations/rbac_roles/{role_id}` returns one role by ID. Requires the `read:members` scope.462463For complete parameter details and response schemas, see [Get role](https://platform.claude.com/docs/en/api/admin/rbac_roles/retrieve) in the API reference.464465```bash cURL466curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv" \467 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \468 -H "anthropic-version: 2023-06-01"469```470471### List a role's permissions472473`GET /v1/organizations/rbac_roles/{role_id}/permissions` returns the role's permissions. Each permission pairs a `resource` (what it applies to: the organization's product features, a connector tool, a connector OAuth scope, one connector, or every connector) with an `action` (what it grants on that resource). Rows for features not enabled for your organization are omitted, so a page might contain fewer than `limit` rows while `has_more` is `true`. Requires the `read:members` scope.474475Two `action` values need special care: an `organization` permission whose action is `capability_access_all` (every product feature) or `capability_access_all_ga` (every stable product feature, that is, every feature not labeled beta or research preview) is a blanket grant (one that covers neither model access nor the `permission_`-prefixed admin-panel permissions) and is listed as that single row rather than expanded. When you tally what a role grants, treat a blanket row as covering everything its variant describes, not just the features named in other rows.476477For complete parameter details and response schemas, see [List role permissions](https://platform.claude.com/docs/en/api/admin/rbac_roles/permissions/list) in the API reference.478479```bash cURL480curl "https://api.anthropic.com/v1/organizations/rbac_roles/rbac_role_01CdEfGhIjKlMnOpQrStUv/permissions?limit=20" \481 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \482 -H "anthropic-version: 2023-06-01"483```484485```json486{487 "data": [488 {489 "type": "rbac_role_permission",490 "resource": {491 "type": "organization",492 "organization_id": "12345678-1234-5678-1234-567812345678"493 },494 "action": "capability_access_all_ga"495 },496 {497 "type": "rbac_role_permission",498 "resource": {499 "type": "connector_tool",500 "connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",501 "tool_name": "search_tickets"502 },503 "action": "use"504 }505 ],506 "has_more": false,507 "next_page": null508}509```510511## Example workflows512513### Offboard a departing employee5145151. Look up the member by email:516517 ```bash cURL518 curl "https://api.anthropic.com/v1/organizations/users?email=departing@example.com" \519 -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \520 -H "anthropic-version: 2023-06-01"521 ```5225232. Remove them with `DELETE /v1/organizations/users/{user_id}`, using the `id` from the response. Their seat, if any, returns to the pool.5245253. If the person had not yet joined, the lookup returns no member; list invites and withdraw their `pending` invite instead.526527### Audit group membership5285291. List groups and record each group's `id`, `name`, and `roles`.5305312. For each group that carries sensitive roles, page through `GET /v1/organizations/rbac_groups/{group_id}/members` and compare the member emails against your identity provider's roster.5325333. Remove members who should no longer be in the group with `DELETE /v1/organizations/rbac_groups/{group_id}/members/{user_id}`. For `scim` groups, make the change in your identity provider instead.534535For a workflow that combines group membership with a temporary spend limit raise, see [Temporarily raise a member's spend limit during an incident](https://platform.claude.com/docs/en/manage-claude/spend-limits-api#temporarily-raise-a-members-spend-limit-during-an-incident) on the Spend Limits API page.536537## Frequently asked questions538539### Is this a different API from the Admin API?540541No. The member and invite endpoints are the same `/v1/organizations/` endpoints that Claude Console organizations use; this page documents their Claude Enterprise behavior. The group and custom-role endpoints are part of the same API and exist only for Claude Enterprise organizations. The [availability table](https://platform.claude.com/docs/en/manage-claude/user-management#which-endpoints-can-your-organization-use) shows which endpoints each organization type can call.542543### Can I assign the owner or membership admin role through the API?544545No. The API assigns only `user` and `managed`, on invite creation and role updates. Administrative roles are assigned in claude.ai organization settings, and members holding them cannot be modified or removed through the API.546547### Can I create or modify groups through the API?548549Yes, with the `write:rbac_groups` scope: create, rename, and delete groups, and add or remove their members. Two things the API cannot change: groups provisioned by your identity provider (`source_type: "scim"`), whose name and membership are owned by the identity provider, and custom roles, which are managed in claude.ai organization settings (the API [reads them](https://platform.claude.com/docs/en/manage-claude/user-management#custom-roles)).550551### Does an unaccepted invite consume a seat?552553On plans with a finite seat pool, yes: a `pending` invite holds a seat. Withdrawing the invite or letting it expire frees the seat. On plans without a seat pool, invites consume nothing.554555### My organization uses single sign-on. Which operations work?556557If your identity provider provisions users automatically (JIT or SCIM), invite creation returns 400. If it manages roles (advanced SSO or advanced SCIM provisioning), role updates return 400. If it manages membership (SCIM provisioning), member removals return 400. Reads work regardless.558559### What happens to an Admin API key when the person who created it leaves?560561The key keeps working. Admin API keys are scoped to the organization, not to individual users, and a key created in claude.ai does not expire. Removing the creator from the organization or deprovisioning them through your identity provider ends their own access, but not the keys they created. Downgrading their role does not change the keys either: each key stays active with its original scopes. When you offboard someone who created Admin API keys, delete those keys in the **Keys** section of [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) and create replacements.562563## See also564565<CardGroup cols={2}>566 <Card title="Create an Admin API key" href="https://platform.claude.com/docs/en/manage-claude/admin-api-keys">567 Where your primary owner creates a scoped key and which scopes to select.568 </Card>569570 <Card title="Compliance API" href="https://platform.claude.com/docs/en/manage-claude/compliance-api">571 Audit activity and retrieve or delete user content across your organization.572 </Card>573574 <Card title="Analytics APIs" href="https://platform.claude.com/docs/en/manage-claude/analytics-api">575 Per-user and time-bucketed usage and cost reporting for Claude Enterprise.576 </Card>577578 <Card title="Spend Limits API" href="https://platform.claude.com/docs/en/manage-claude/spend-limits-api">579 Set per-member spend limits and review increase requests.580 </Card>581</CardGroup>582