Claude Platform Docs
管理组织

用户管理

使用 Admin API 管理您 Claude Enterprise 组织中的人员:列出成员并更改角色、发送和撤回邀请、管理群组以及读取自定义角色。

本页介绍如何使用 Admin API 以编程方式管理您的 Claude Enterprise(claude.ai)组织中的人员:

  • 列出成员并按电子邮件地址查找成员
  • 更改成员的角色
  • 移除成员,或在不移除成员的情况下将其从所有位置登出(beta)
  • 发送和撤回邀请
  • 管理您企业的群组及其成员
  • 读取您组织的自定义角色

对于 Claude Console(Claude Platform)组织,请参阅 Claude Console 的 Admin API 指南。

您的组织可以使用哪些端点?

Admin API 是位于 https://api.anthropic.com/v1/organizations/ 下的一组统一的端点。Claude Console 和 Claude Enterprise 组织使用不同的 Admin API 密钥进行身份验证,并且各自可以访问不同的端点子集:

端点Claude Console(Claude Platform)Claude Enterprise(claude.ai)
成员和邀请可用;请参阅 Admin API 指南可用(本页)
群组不可用可用(本页)
自定义角色不可用可用,只读(本页)
插件 API和 Claude Tag不可用以 beta 形式提供
支出限额不可用可用
用量和成本报告可用;请参阅用量和成本分析 API通过用量和成本分析 API以及 Claude Enterprise 分析 API 提供
工作区、API 密钥、速率限制以及 Admin API 指南中的其他端点可用不可用

成员和邀请对两种组织类型使用相同的端点;本页记录它们在 Claude Enterprise 中的行为,包括 Claude Enterprise 的组织角色。群组和自定义角色端点仅适用于 Claude Enterprise。

概述

本页涵盖五种资源:

资源端点用途
成员GET /v1/organizations/users
GET /v1/organizations/users/{user_id}
POST /v1/organizations/users/{user_id}
DELETE /v1/organizations/users/{user_id}
POST /v1/organizations/users/{user_id}/sign_out(beta)
列出组织的成员或按电子邮件查找成员;更改成员的角色;移除成员;将成员从所有位置登出。
邀请POST /v1/organizations/invites
GET /v1/organizations/invites
GET /v1/organizations/invites/{invite_id}
DELETE /v1/organizations/invites/{invite_id}
邀请某人加入组织、跟踪邀请状态,并在邀请被接受前撤回。
群组GET /v1/organizations/rbac_groups
GET /v1/organizations/rbac_groups/{rbac_group_id}
POST /v1/organizations/rbac_groups
POST /v1/organizations/rbac_groups/{rbac_group_id}
DELETE /v1/organizations/rbac_groups/{rbac_group_id}
读取企业的群组以及附加到每个群组的自定义角色;创建、重命名和删除群组。
群组成员GET /v1/organizations/rbac_groups/{rbac_group_id}/members
POST /v1/organizations/rbac_groups/{rbac_group_id}/members
DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}
读取群组的成员;添加和移除成员。
自定义角色GET /v1/organizations/rbac_roles
GET /v1/organizations/rbac_roles/{rbac_role_id}
GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions
读取组织的自定义角色以及每个角色授予的权限。

自定义角色及其群组附加关系在 claude.ai 组织设置中管理;API 可以读取它们,但无法更改它们。

快速入门

将 ANTHROPIC_API_KEY 环境变量设置为您的 Admin API 密钥。本页上的示例会从该变量读取密钥。SDK 和 ant CLI 会为您发送 Authorization 和 anthropic-version 标头。

列出组织的成员,最新的排在最前:

client = anthropic.Anthropic()

users = client.organization.users.list(limit=20)

for user in users:
    print(f"{user.id}: {user.email} ({user.role})")
{
  "data": [
    {
      "type": "user",
      "id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "jane@example.com",
      "name": "Jane Smith",
      "role": "user",
      "added_at": "2026-06-12T09:14:03Z"
    }
  ],
  "has_more": false,
  "first_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "last_id": "user_01AbCdEfGhIjKlMnOpQrSt"
}

关键概念

组织角色

每个成员恰好拥有一个组织角色。读取操作会将成员的角色返回为以下五个值之一:

角色含义
user标准成员。
managed其权限通过附加到其所在群组的自定义角色授予的成员。
owner组织所有者。
membership_admin可以管理组织成员的成员。
primary_owner组织的主所有者。有且仅有一个。

API 只能在创建邀请和更新角色时分配 user 和 managed 角色。分配 managed 时,除 write:members 外还需要 write:rbac_groups 作用域,因为受管成员的权限来自附加到其所在群组的自定义角色。管理角色(owner、membership_admin 和 primary_owner)在 claude.ai 组织设置中分配,持有这些角色的成员无法通过此 API 修改或移除。

成员和邀请

一个人通过接受邀请(或在已配置的情况下通过组织的单点登录)成为成员。创建邀请会发送一封邀请电子邮件;之后邀请的状态显示为 pending,直到收件人接受(accepted)或超过服务器分配的 expires_at(expired)。只有 pending 状态的邀请可以撤回。要更改待处理邀请的电子邮件地址或角色,请撤回该邀请并创建一个新邀请。

如果您组织的套餐从有限的已购席位池中分配成员,则待处理的邀请会占用一个席位。创建邀请端点不接受席位或层级参数:席位会自动从有可用席位的最低层级中分配。在没有空闲席位时创建邀请会失败并返回 400 错误,而不会购买席位。撤回邀请、让邀请过期或之后移除该成员都会将席位归还到池中。

群组和角色

群组将成员与自定义角色关联起来(即 “role-based access control”(基于角色的访问控制),也就是端点路径和作用域名称中的 rbac)。群组归您的父组织及其下的每个组织所有,而不是归某个单一组织所有。因此,群组作用域(read:rbac_groups 和 write:rbac_groups)需要适用于所有关联组织的密钥。每个群组都带有一个 source_type:在 claude.ai 中创建的群组为 direct,由您的身份提供商预配的群组为 scim。群组的 role_ids 字段列出了附加到该群组的自定义角色的 ID。请使用自定义角色端点将其解析为名称和权限。每个组织都有自己的角色目录,但群组在您的父组织范围内共享。因此,获取属于您父组织下其他组织的角色时,您的密钥会收到 404。当角色数据暂时不可用时,role_ids 字段为 null(而不是 []),因此请重试,以区分降级读取与没有角色的群组。

版本控制

在每个请求中发送 anthropic-version 标头;有关可用版本,请参阅版本。

速率限制

Admin API 端点共享每个组织每分钟 100 个请求的限制;邀请创建则有其单独的限制,为每小时 1,200 个请求。超出限制的请求会返回 429 Too Many Requests。

分页

成员和邀请列表使用基于 ID 的分页:传入 limit(默认 20,最大 1,000),以及 before_id 或 after_id 中的至多一个,并使用每个响应的 first_id 和 last_id 字段进行翻页,直到 has_more 为 false。群组和自定义角色列表则使用不透明游标(opaque cursor):在下一个请求中将响应的 next_page 值原样作为 page 参数传入,直到 next_page 为 null。

当您遍历结果时,SDK 会为您获取更多页面,因此 limit 设置的是页面大小,而不是总数。在 CLI 中,对于成员和邀请列表,--limit 设置结果总数。对于群组和角色列表,它设置页面大小。

错误响应

错误响应遵循 Claude API 错误中记录的标准格式。

成员

列出成员

GET /v1/organizations/users 返回组织的成员,最近添加的排在最前。按 email 筛选可查找特定成员;匹配不区分大小写,并且可以容忍同一地址的常见变体(例如,jane+hiring@example.com 匹配 jane@example.com)。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出用户可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

users = client.organization.users.list(email="jane@example.com")

for user in users:
    print(f"{user.id}: {user.email} ({user.role})")

获取成员

GET /v1/organizations/users/{user_id} 按 ID 返回一个成员。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的获取用户可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

user = client.organization.users.retrieve("user_01AbCdEfGhIjKlMnOpQrSt")

print(f"id: {user.id}")
print(f"email: {user.email}")
print(f"role: {user.role}")

更改成员的角色

POST /v1/organizations/users/{user_id} 将成员的角色设置为 user 或 managed。持有管理角色(owner、membership_admin 或 primary_owner)的成员无法通过此端点更改,也无法分配管理角色;这两种情况都会返回 400,并且需要在 claude.ai 组织设置中管理。如果您组织的身份提供商管理角色(高级 SSO 或高级 SCIM 预配),角色更新会返回 400。需要 write:members 作用域,将角色更改为 managed 时还需要 write:rbac_groups。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的更新用户可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

user = client.organization.users.update("user_01AbCdEfGhIjKlMnOpQrSt", role="managed")

print(f"id: {user.id}")
print(f"role: {user.role}")

移除成员

DELETE /v1/organizations/users/{user_id} 将成员从组织中移除,并将其占用的任何已购席位归还到组织的池中。持有管理角色的成员无法通过此端点移除;如果您的身份提供商管理成员资格(SCIM),移除操作会返回 400。需要 write:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的移除用户可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

removed_user = client.organization.users.remove("user_01AbCdEfGhIjKlMnOpQrSt")

print(f"id: {removed_user.id}")
{
  "type": "user_deleted",
  "id": "user_01AbCdEfGhIjKlMnOpQrSt"
}

在所有位置登出成员

POST /v1/organizations/users/{user_id}/sign_out 会在每个浏览器和设备上将成员登出 Claude,而不会将其从组织中移除。当成员的设备丢失或被盗、发生安全事件时,或者在您决定是否移除该成员之前调查其账户期间,请使用此端点。需要 write:members 权限范围。

登出会作用于该用户的整个 Claude 账户,包括其在其他组织中以及个人计划中的会话。该成员会保留其席位和角色,并且可以立即重新登录。若要阻止某人访问,请移除该成员,或者如果您的组织要求单点登录,请在您的身份提供商中禁用其账户。禁用账户会阻止新的登录,但该用户仍会保留在您的成员列表中。如果您移除了某人但其身份提供商账户仍处于活动状态,自动预配可能会在其下次登录时将其重新添加。如果您的身份提供商管理成员资格,则只能在身份提供商中移除该成员。

请在需要之前提前创建密钥。请参阅为 Claude Enterprise 组织创建密钥。write:members 密钥仅在创建它的组织中有效,因此每个关联的组织都需要各自的密钥。该密钥由该组织的主要所有者创建。若要使用同一密钥按电子邮件地址查找成员,还需选择 read:members 权限范围。

该请求没有请求体。请传入成员的 id(由列出成员返回):

client = anthropic.Anthropic()

user = client.beta.organization.users.sign_out("user_01AbCdEfGhIjKlMnOpQrSt")

print(f"id: {user.id}")

成功的请求会返回 200 以及该成员信息,其角色和其他字段保持不变:

{
  "type": "user",
  "id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "email": "jane@example.com",
  "name": "Jane Smith",
  "role": "user",
  "added_at": "2026-06-12T09:14:03Z"
}

如果您还没有密钥,所有者可以改为在 claude.ai 组织设置的"成员"页面上使用在所有设备上退出登录操作。它会结束相同的会话、受信任设备和 OAuth 令牌,并移除相同的推送通知注册。所有者不能对自己的账户使用此操作:他们需要在 claude.ai 的账户设置中登出自己的会话。

请求会结束的内容

该请求会为该成员结束以下所有内容:

  • 登录会话:该用户账户在每个浏览器和设备上的所有登录会话。
  • 受信任设备:该用户为敏感操作注册为受信任的每个浏览器、计算机或手机。该用户必须重新注册每台设备。
  • 为此组织签发的 OAuth 令牌:无论由哪个应用持有,例如 Claude Code 或第三方应用。这些应用必须重新登录。令牌几乎总是会立即失效,最长不超过一小时。

该请求还会清除该用户选择跳过 Claude 两步验证的浏览器记录,以便在这些浏览器上下次登录时再次要求第二步验证。它还会移除 Claude 为该用户的手机、桌面应用和浏览器保存的推送通知注册,使 Claude 停止向这些设备发送通知。此移除操作是异步执行的:通常在一分钟内完成,但在极少数情况下可能需要更长时间。返回 200 并不能确认这两个步骤已完成。

只有 OAuth 令牌仅限于此组织。会话、受信任设备和推送通知注册属于该用户的账户,因此登出也会作用于其所属的其他组织以及任何个人计划。

该请求不会删除已存储在设备上的任何内容。

请求不会结束的内容

该请求不会结束以下任何内容:

  • API 密钥:它们会继续有效,包括该用户创建的 Admin API 密钥。若要停用 Admin API 密钥,请在 claude.ai > 组织设置 > API 的密钥部分将其删除。
  • 其他组织的 OAuth 令牌:若要结束这些令牌,请在每个组织中使用该组织的密钥发送请求。该用户在每个组织中的 id 都相同。签发给该用户账户而非某个组织的 OAuth 令牌也会继续有效,且此请求无法结束它们。
  • Claude Code 云端会话和例程:在 Anthropic 基础设施上运行的会话(例如网页版 Claude Code),或在您的某个自托管环境中运行的会话会继续运行。在您发送请求时正在进行的工作,或在请求后不久开始的工作,可能会失败。随后该会话会在用户无需重新登录的情况下获得新凭据并继续运行。该用户按计划或根据 GitHub 事件运行的例程会继续启动新会话。在所有设备上退出登录操作同样不会停止这些内容。
  • 与 Cowork 关联的计算机:它们会保持关联。
  • 正在进行的登录:已经在进行中的登录可能会在请求期间或请求后最多 5 分钟内完成。如果审计日志导出或活动源显示该用户在请求之后登录,请再次发送请求。登录 Claude Code 等应用的操作不会记录在这些位置,因此如果该用户当时正在登录此类应用,请在 5 分钟后再次发送请求。

无法登出的对象

该请求无法登出组织的主要所有者:它会返回 400,错误代码为 cannot_sign_out_primary_owner。您组织中的任何人都无法登出主要所有者,在"成员"页面上也不行。主要所有者需要在 claude.ai 的账户设置中登出自己的会话。

具有 write:members 权限范围的密钥可以登出其他所有人。这包括所有者、其自定义角色包含管理所有者权限的成员,以及具有 membership_admin 角色的成员。所有者和主要所有者可以通过"成员"页面上的在所有设备上退出登录操作执行相同的操作。只有该成员在此组织中的角色才会被考虑,因此您可以登出在其他组织中担任主要所有者的人。

在创建密钥的人更改角色或离开组织后,该密钥仍会继续有效。请参阅创建 Admin API 密钥的人离开后,该密钥会怎样?。

响应

状态含义
200登出已完成。可以安全地重试:没有剩余可结束内容的请求也会返回 200,第二次请求会结束该用户自第一次请求以来获得的任何会话、受信任设备或 OAuth 令牌。
400 cannot_sign_out_primary_owner该成员是主要所有者,无法被登出。请参阅无法登出的对象。
400 organization_not_enrolled_in_beta此端点对您的组织不可用。
400请求缺少 anthropic-beta 值(消息中会指明该值),或者路径中的 id 不以 user_ 开头。
401密钥缺失、无效或已删除,或者该密钥是为父组织创建的,未绑定到某个组织。
403密钥缺少 write:members 权限范围。
404您的组织中不存在具有该 ID 的成员。
429该组织超出了 Admin API 端点共享的速率限制。retry-after 标头会指明何时重试。登出没有单独的限制。
503请求所需的某项服务暂时不可用。请求已结束的内容会保持结束状态。请再次发送请求以结束其余内容。

错误响应遵循 Claude API 错误中记录的标准格式,错误代码位于 error.details.error_code 中:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "...",
    "details": {
      "error_code": "cannot_sign_out_primary_owner"
    }
  },
  "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}

登出的记录位置

每次完成的登出都会记录为 org_user_trusted_devices_revoked,与在所有设备上退出登录操作记录的事件相同。它会出现在所有者从 claude.ai 下载的审计日志导出中。如果您的组织拥有 Compliance API,它还会出现在活动源中,并附带该请求结束的受信任设备和会话的数量。中途停止的请求也会出现在活动源中,其 completed 设置为 false,但不会出现在审计日志中。

邀请

创建邀请

POST /v1/organizations/invites 发送一封邀请电子邮件,并返回带有服务器分配的 expires_at 的邀请。role 必须为 user 或 managed。如果该电子邮件地址已存在待处理的邀请,或该地址已属于某个成员,请求会返回 400 并指明现有资源。身份提供商自动预配用户(JIT 或 SCIM)的组织无法通过 API 创建邀请。需要 write:members 作用域,当 role 为 managed 时还需要 write:rbac_groups。

在从有限席位池中分配成员的套餐上,邀请会自动从有可用席位的最低层级中占用一个席位。API 不接受层级参数。如果没有空闲席位,请求会失败并返回 400 错误,而不会购买席位。请通过组织的套餐管理添加席位后重试。

可选的 rbac_group_ids 字段列出在成员接受邀请时要分配给该成员的群组(使用带 rbac_group_ 前缀的 ID)。传递非空的 rbac_group_ids 还要求密钥带有 write:rbac_groups 作用域,因为群组分配可能会授予附加到群组角色的权限。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的创建邀请可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

invite = client.organization.invites.create(
    email="newhire@example.com",
    role="managed",
    rbac_group_ids=["rbac_group_01UvWxYzAbCdEfGhIjKlMn"],
)

print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")
print(f"expires_at: {invite.expires_at}")
{
  "type": "invite",
  "id": "invite_01QrStUvWxYzAbCdEfGhIj",
  "email": "newhire@example.com",
  "role": "managed",
  "invited_at": "2026-07-06T16:20:11Z",
  "expires_at": "2026-07-27T16:20:11Z",
  "accepted_at": null,
  "status": "pending",
  "rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
}

列出邀请

GET /v1/organizations/invites 返回组织的邀请,最新的排在最前,涵盖 pending、accepted 和 expired 状态。若只想列出处于特定状态的邀请,请为每个状态传递一次 statuses[],例如 statuses[]=pending。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出邀请可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

invites = client.organization.invites.list(limit=20)

for invite in invites:
    print(f"{invite.id}: {invite.email} ({invite.status})")

获取邀请

GET /v1/organizations/invites/{invite_id} 按 ID 返回一个邀请。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的获取邀请可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

invite = client.organization.invites.retrieve("invite_01QrStUvWxYzAbCdEfGhIj")

print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")

撤回邀请

DELETE /v1/organizations/invites/{invite_id} 撤回一个 pending 状态的邀请,使邀请电子邮件中的链接失效。撤回 accepted 状态的邀请会返回 400(请改为移除该成员);撤回 expired 状态的邀请会返回 400。需要 write:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的删除邀请可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

deleted_invite = client.organization.invites.delete("invite_01QrStUvWxYzAbCdEfGhIj")

print(f"id: {deleted_invite.id}")

群组

您的企业直接创建的群组(在 claude.ai 组织设置中或通过此 API 创建,source_type: "direct")支持本节中的所有端点。由您的身份提供商预配的群组(source_type: "scim")可以读取但不能修改:重命名或删除 SCIM 群组,或更改其成员资格,都会返回 400,因为该群组归您的身份提供商所有。

列出群组

GET /v1/organizations/rbac_groups 返回您企业的群组,包括由身份提供商管理的(scim)群组。需要 read:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出群组可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

groups = client.beta.organization.rbac_groups.list(limit=20)

for group in groups:
    print(f"{group.id}: {group.name} ({group.source_type})")
{
  "data": [
    {
      "type": "rbac_group",
      "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "name": "Engineering",
      "source_type": "direct",
      "role_ids": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

获取群组

GET /v1/organizations/rbac_groups/{rbac_group_id} 按 ID 返回一个群组。需要 read:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的获取群组可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

group = client.beta.organization.rbac_groups.retrieve(
    "rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)

print(f"id: {group.id}")
print(f"name: {group.name}")
print(f"source_type: {group.source_type}")

创建群组

POST /v1/organizations/rbac_groups 使用给定的 name(1–255 个字符)创建一个没有角色或成员的群组。需要 write:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的创建群组可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

group = client.beta.organization.rbac_groups.create(name="Engineering")

print(f"id: {group.id}")
print(f"name: {group.name}")
{
  "type": "rbac_group",
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "name": "Engineering",
  "source_type": "direct",
  "role_ids": [],
  "created_at": "2026-07-09T18:00:00Z",
  "updated_at": "2026-07-09T18:00:00Z"
}

重命名群组

POST /v1/organizations/rbac_groups/{rbac_group_id} 更新群组。name 是此端点唯一可以更改的字段。需要 write:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的更新群组可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

group = client.beta.organization.rbac_groups.update(
    "rbac_group_01UvWxYzAbCdEfGhIjKlMn", name="Platform Engineering"
)

print(f"id: {group.id}")
print(f"name: {group.name}")

删除群组

DELETE /v1/organizations/rbac_groups/{rbac_group_id} 删除群组。其成员仍然是各自组织的成员,但会失去该群组所附加角色的权限,并且群组支出限额(如果存在)将不再适用于他们。需要 write:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的删除群组可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

deleted_group = client.beta.organization.rbac_groups.delete(
    "rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)

print(f"id: {deleted_group.id}")
{
  "id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "type": "rbac_group_deleted"
}

列出群组的成员

GET /v1/organizations/rbac_groups/{rbac_group_id}/members 返回群组的成员(每个成员都带有其 user_id 和电子邮件),最早的排在最前。只会返回您企业各组织的当前成员,因此在 has_more 为 true 时,一个页面包含的条目可能少于 limit。需要 read:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出群组成员可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

members = client.beta.organization.rbac_groups.members.list(
    "rbac_group_01UvWxYzAbCdEfGhIjKlMn", limit=100
)

for member in members:
    print(f"{member.user_id}: {member.email}")
{
  "data": [
    {
      "type": "rbac_group_member",
      "rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
      "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
      "email": "jane@example.com",
      "created_at": "2026-04-07T12:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

向群组添加成员

POST /v1/organizations/rbac_groups/{rbac_group_id}/members 按 user_id 将组织成员添加到群组。该用户必须已经是您企业某个组织的成员(否则请求返回 404),添加已在群组中的人员会返回 400。对于 scim 群组,成员资格在您的身份提供商中管理,此请求会返回 400。要为尚未加入的人员分配群组,请改为在创建邀请时使用 rbac_group_ids。需要 write:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的添加群组成员可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

member = client.beta.organization.rbac_groups.members.add(
    "rbac_group_01UvWxYzAbCdEfGhIjKlMn", user_id="user_01AbCdEfGhIjKlMnOpQrSt"
)

print(f"user_id: {member.user_id}")
print(f"email: {member.email}")
{
  "type": "rbac_group_member",
  "rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "email": "jane@example.com",
  "created_at": "2026-07-09T18:00:00Z"
}

从群组中移除成员

DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} 将成员从群组中移除;该成员仍然是其组织的成员。如果该用户不是群组成员,请求返回 404;对于 scim 群组(其成员资格在您的身份提供商中管理),请求返回 400。需要 write:rbac_groups 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的移除群组成员可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

removed_member = client.beta.organization.rbac_groups.members.remove(
    "user_01AbCdEfGhIjKlMnOpQrSt", rbac_group_id="rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)

print(f"user_id: {removed_member.user_id}")
{
  "rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
  "user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
  "type": "rbac_group_member_deleted"
}

自定义角色

自定义角色通过 API 是只读的:这些端点列出您组织的自定义角色(在 claude.ai 组织设置中定义或由 Anthropic 预配)以及每个角色授予的权限。自定义角色读取使用 read:members 作用域(没有单独的角色作用域),可以使用组织级密钥,并且返回的目录是您组织自己的目录。

从角色的 display_name 字段读取其名称。对于由 Anthropic 预配的角色,display_name 可能与 claude.ai 显示的标签不同,并且 Anthropic 可能会更改该名称。要持久引用某个角色,请存储其 id。

列出角色

GET /v1/organizations/rbac_roles 返回您组织的自定义角色。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出角色可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

roles = client.beta.organization.rbac_roles.list(limit=20)

for role in roles:
    print(f"{role.id}: {role.display_name}")
{
  "data": [
    {
      "type": "rbac_role",
      "id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",
      "display_name": "Engineering base",
      "created_at": "2026-03-18T10:01:42Z",
      "updated_at": "2026-05-02T08:55:09Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

获取角色

GET /v1/organizations/rbac_roles/{rbac_role_id} 按 ID 返回一个角色。需要 read:members 作用域。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的获取角色可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

role = client.beta.organization.rbac_roles.retrieve("rbac_role_01CdEfGhIjKlMnOpQrStUv")

print(f"id: {role.id}")
print(f"display_name: {role.display_name}")

列出角色的权限

GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions 返回角色的权限。每个权限将一个 resource(其适用对象:组织的产品功能、某个连接器工具、某个连接器 OAuth 作用域、单个连接器或所有连接器)与一个 action(其在该资源上授予的内容)配对。未为您的组织启用的功能所对应的行会被省略,因此在 has_more 为 true 时,一个页面包含的行可能少于 limit。需要 read:members 作用域。

有两个 action 值需要特别注意。action 为 capability_access_all(所有产品功能)或 capability_access_all_ga(所有稳定产品功能,即所有未标记为 beta 或研究预览的功能)的 organization 权限是一种全面授权。它以单独一行列出,而不会展开。全面授权既不涵盖模型访问,也不涵盖带 permission_ 前缀的管理面板权限,也不涵盖 inference_hooks_inspection,角色只能通过明确指定它的行来持有该权限。在统计某个角色授予的内容时,请将全面授权行视为涵盖其变体所描述的所有内容,而不仅仅是其他行中列出的功能。

有关完整的参数详细信息和响应架构,请参阅 API 参考中的列出角色权限可查看包含 API 参考文档链接的预览——按 Tab 键直到焦点进入卡片,按 Escape 键返回。。

client = anthropic.Anthropic()

permissions = client.beta.organization.rbac_roles.permissions.list(
    "rbac_role_01CdEfGhIjKlMnOpQrStUv", limit=20
)

for permission in permissions:
    print(permission.action)
{
  "data": [
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "organization",
        "organization_id": "12345678-1234-5678-1234-567812345678"
      },
      "action": "capability_access_all_ga"
    },
    {
      "type": "rbac_role_permission",
      "resource": {
        "type": "connector_tool",
        "connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",
        "tool_name": "search_tickets"
      },
      "action": "use"
    }
  ],
  "has_more": false,
  "next_page": null
}

示例工作流

为离职员工办理离职

  1. 按电子邮件查找成员:

    client = anthropic.Anthropic()
    
    users = client.organization.users.list(email="departing@example.com")
    
    for user in users:
        print(f"{user.id}: {user.email} ({user.role})")
  2. 使用响应中的 id,通过 DELETE /v1/organizations/users/{user_id} 移除该成员。其席位(如果有)会归还到池中。

  3. 如果此人尚未加入,查找将不会返回任何成员;请改为列出邀请并撤回其 pending 状态的邀请。

应对设备丢失或被盗

在需要此工作流之前,请为登出端点创建一个具有 write:members 和 read:members 作用域的密钥。如果您还没有密钥,所有者可以在 claude.ai 组织设置的"成员"页面上使用在所有设备上退出登录操作来代替第 2 至 4 步。所有者不能对自己的账户使用此操作:他们需要在 claude.ai 的账户设置中登出自己的会话。

  1. 首先,将该用户从您的身份提供商中登出,或在其中禁用其账户。否则,持有丢失设备的人可以通过该设备的身份提供商会话或该用户的邮箱再次登录 Claude。

  2. 按电子邮件地址查找该成员,方法与为离职员工办理离职的第 1 步相同。电子邮件匹配可以容忍同一地址的变体,因此请检查响应是否为正确的人。

  3. 使用响应中的 id,通过 POST /v1/organizations/users/{user_id}/sign_out 将其登出。在所有位置登出成员列出了该请求所需的标头以及它会结束的内容。

  4. 如果请求返回 503,请再次发送,直到返回 200。如果返回 400 并带有 cannot_sign_out_primary_owner,请参阅无法登出的对象。

  5. 检查审计日志导出或活动源,查看第一次请求之后是否有登录。如果发现有登录,或者该用户当时正在登录 Claude Code 等应用,请在 5 分钟后再次发送请求。如果您无法发送请求,请改为再次使用在所有设备上退出登录操作。这也会将该成员从其此后启动的任何会话中登出,因此请事先告知他们。

  6. 在登出的记录位置确认登出,并查看请求不会结束的内容。

审计群组成员资格

  1. 列出群组,并记录每个群组的 id、name 和 role_ids。

  2. 对于每个带有敏感角色的群组,翻页浏览 GET /v1/organizations/rbac_groups/{rbac_group_id}/members,并将成员电子邮件与您身份提供商的名册进行比较。

  3. 使用 DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} 移除不应再留在群组中的成员。对于 scim 群组,请改为在您的身份提供商中进行更改。

有关将群组成员资格与临时提高支出限额相结合的工作流,请参阅支出限额 API 页面上的在事件期间临时提高成员的支出限额。

常见问题

这是与 Admin API 不同的 API 吗?

不是。成员和邀请端点与 Claude Console 组织使用的 /v1/organizations/ 端点相同;本页记录它们在 Claude Enterprise 中的行为。群组和自定义角色端点属于同一个 API,并且仅适用于 Claude Enterprise 组织。可用性表显示了每种组织类型可以调用哪些端点。

API 可以分配所有者或成员管理员角色吗?

不可以。API 仅在创建邀请和更新角色时分配 user 和 managed。管理角色在 claude.ai 组织设置中分配,持有这些角色的成员无法通过 API 修改或移除。

API 可以创建或修改群组吗?

可以,使用 write:rbac_groups 作用域即可:创建、重命名和删除群组,以及添加或移除其成员。有两类内容无法通过 API 更改:由您的身份提供商预配的群组(source_type: "scim"),其名称和成员归身份提供商所有;以及自定义角色,它们在 claude.ai 组织设置中管理(API 只读取它们)。

未接受的邀请会占用席位吗?

在具有有限席位池的套餐上,会:pending 状态的邀请会占用一个席位。撤回邀请或让其过期会释放该席位。在没有席位池的套餐上,邀请不会占用任何资源。

当您的组织使用单点登录时,哪些操作可用?

如果您的身份提供商自动预配用户(JIT 或 SCIM),创建邀请会返回 400。如果它管理角色(高级 SSO 或高级 SCIM 预配),角色更新会返回 400。如果它管理成员资格(SCIM 预配),移除成员会返回 400。读取操作在任何情况下都可用。将成员从所有位置登出也是如此,无论您的组织使用哪种单点登录模式。

登出成员能阻止其访问吗?

不能。登出成员会结束其登录会话、受信任设备以及您组织的 OAuth 令牌,但他们可以立即重新登录。若要阻止某人访问,请移除该成员,或者如果您的组织要求单点登录,请在您的身份提供商中禁用其账户。仅禁用账户可能无法结束已经打开的会话,因此请先将该用户从您的身份提供商中登出,然后将其登出 Claude,再移除该成员或禁用其账户。

当创建 Admin API 密钥的人离职时,该密钥会怎样?

该密钥会继续有效。Admin API 密钥的作用范围是组织,而不是个人用户,并且在 claude.ai 中创建的密钥不会过期。将创建者从组织中移除或通过您的身份提供商取消其预配,会终止其本人的访问权限,但不会影响其创建的密钥。降低其角色也不会改变这些密钥:每个密钥都会保持有效并保留其原始作用域。当您为创建过 Admin API 密钥的人员办理离职时,请在 claude.ai > 组织设置 > API 的密钥部分删除这些密钥并创建替代密钥。

另请参阅

在何处创建带作用域的密钥以及应选择哪些作用域。

审计活动,并检索或删除整个组织中的用户内容。

跟踪您组织的令牌用量和成本。

设置每个成员的支出限额并审核提额请求。

此页面对您有帮助吗?