The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Admin API 允许您以编程方式管理组织的资源，包括组织成员、工作空间和 API 密钥。这提供了对管理任务的编程控制，否则这些任务需要在 Claude Console 中进行手动配置。
Admin API 需要特殊访问权限Admin API 需要特殊的 Admin API 密钥（以 sk-ant-admin... 开头），这与标准 API 密钥不同。只有具有管理员角色的组织成员才能通过 Claude Console 提供 Admin API 密钥。

​
Admin API 的工作原理

当您使用 Admin API 时：
  1. 您在 x-api-key 标头中使用您的 Admin API 密钥发出请求
  2. API 允许您管理：
    • 组织成员及其角色
    • 组织成员邀请
    • 工作空间及其成员
    • API 密钥
这对以下用途很有用：
  • 自动化用户入职/离职
  • 以编程方式管理工作空间访问
  • 监控和管理 API 密钥使用情况

​
组织角色和权限

有五个组织级别的角色。查看更多详细信息 这里。
角色权限
user可以使用 Workbench
claude_code_user可以使用 Workbench 和 Claude Code
developer可以使用 Workbench 和管理 API 密钥
billing可以使用 Workbench 和管理账单详细信息
admin可以执行上述所有操作，以及管理用户

​
关键概念

​
组织成员

您可以列出 组织成员，更新成员角色，以及移除成员。 
# 列出组织成员
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 更新成员角色
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# 移除成员
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
组织邀请

您可以邀请用户加入组织并管理这些 邀请。 
# 创建邀请
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "role": "developer"
  }'

# 列出邀请
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 删除邀请
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
工作空间

创建和管理 工作空间 (控制台) 来组织您的资源： 
# 创建工作空间
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# 列出工作空间
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 归档工作空间
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
工作空间成员

管理 用户对特定工作空间的访问： 
# 将成员添加到工作空间
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# 列出工作空间成员
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 更新成员角色
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# 从工作空间移除成员
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

​
API 密钥

监控和管理 API 密钥： 
# 列出 API 密钥
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 更新 API 密钥
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

​
访问组织信息

使用 /v1/organizations/me 端点以编程方式获取有关您组织的信息。 例如： 
curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

{
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}
此端点对于以编程方式确定 Admin API 密钥属于哪个组织很有用。 有关完整的参数详细信息和响应模式，请参阅 组织信息 API 参考。

​
访问使用情况和成本报告

要访问您组织的使用情况和成本报告，请使用使用情况和成本 API 端点：
  • 使用情况端点 (/v1/organizations/usage_report/messages) 提供详细的使用数据，包括令牌计数和请求指标，按工作空间、用户和模型等各种维度分组。
  • 成本端点 (/v1/organizations/cost_report) 提供与您组织使用情况相关的成本数据，允许您跟踪费用并按工作空间或描述分配成本。
这些端点提供了对您组织使用情况和相关成本的详细洞察。

​
访问 Claude Code 分析

对于使用 Claude Code 的组织，Claude Code Analytics API 提供详细的生产力指标和使用洞察：
  • Claude Code Analytics 端点 (/v1/organizations/usage_report/claude_code) 提供 Claude Code 使用情况的每日聚合指标，包括会话、代码行数、提交、拉取请求、工具使用统计和按用户和模型细分的成本数据。
此 API 使您能够跟踪开发人员生产力、分析 Claude Code 采用情况，并为您的组织构建自定义仪表板。

​
最佳实践

要有效使用 Admin API：
  • 为工作空间和 API 密钥使用有意义的名称和描述
  • 为失败的操作实施适当的错误处理
  • 定期审核成员角色和权限
  • 清理未使用的工作空间和过期的邀请
  • 监控 API 密钥使用情况并定期轮换密钥

​
常见问题

只有具有管理员角色的组织成员才能使用 Admin API。他们还必须拥有特殊的 Admin API 密钥（以 sk-ant-admin 开头）。
不可以，出于安全原因，新的 API 密钥只能通过 Claude Console 创建。Admin API 只能管理现有的 API 密钥。
API 密钥保持其当前状态，因为它们的作用域是组织，而不是个人用户。
不可以，出于安全原因，具有管理员角色的组织成员无法通过 API 移除。
组织邀请在 21 天后过期。目前没有办法修改此过期期限。
是的，每个组织最多可以有 100 个工作空间。已归档的工作空间不计入此限制。
每个组织都有一个”默认工作空间”，无法编辑或删除，并且没有 ID。此工作空间不会出现在工作空间列表端点中。
组织管理员自动获得所有工作空间的 workspace_admin 角色。组织账单成员自动获得 workspace_billing 角色。组织用户和开发人员必须手动添加到每个工作空间。
组织用户和开发人员可以被分配 workspace_admin、workspace_developer 或 workspace_user 角色。workspace_billing 角色无法手动分配 - 它是从拥有组织 billing 角色继承的。
只有组织账单成员可以将其工作空间角色升级为管理员角色。否则，组织管理员和账单成员在持有这些组织角色时无法更改其工作空间角色或从工作空间中移除。必须首先更改其组织角色才能修改其工作空间访问权限。
如果组织管理员或账单成员被降级为用户或开发人员，他们将失去对所有工作空间的访问权限，除了那些手动分配角色的工作空间。当用户被提升为管理员或账单角色时，他们获得对所有工作空间的自动访问权限。