Claude Platform Docs

登出用户

$ ant beta:organization:users sign-out
POST/v1/organizations/users/{user_id}/sign_out
Requires anthropic-beta: admin-user-sign-out-2026-10-08. Learn how to send beta headers.

在所有位置将成员登出 Claude,而不会将其从组织中移除。这会在该成员使用 Claude 的所有位置结束其登录会话并移除其受信任设备,包括其他组织和个人计划中的位置。此操作还会使为此组织向其签发的 OAuth 令牌失效,因此 Claude Code 等应用必须重新登录。

令牌最多可能需要一小时才会失效,但几乎总是会立即失效。该成员会保留其角色,并且可以立即重新登录。若要阻止其访问,请将其从组织中移除,或者如果您的组织使用单点登录,请在您的身份提供商中阻止该成员。登出不会使 API 密钥或并非为此组织签发的 OAuth 令牌失效,也不会结束该成员的 Claude Code 云端会话和例程。

您无法登出组织的主要所有者,也无法登出您的 API 密钥或令牌所代表的用户;登出其他所有者、具有所有者权限的成员或成员管理员的请求可能会被拒绝。被拒绝的请求会返回 400 或 403 错误,并说明原因。如果请求返回 503,请重新发送以完成操作;已结束的内容会保持结束状态。

每个请求都必须包含 beta 标头 anthropic-beta: admin-user-sign-out-2026-10-08。缺少该标头的请求会返回 400。登出功能面向 Claude Enterprise 组织处于 beta 阶段。在此功能未启用的组织中,请求会返回 400,且 error_code 为 organization_not_enrolled_in_beta。在 Claude Enterprise 组织中,API 密钥需要 write:members 权限范围;没有该权限范围的密钥会收到 403。

Parameters
--user-id: string⁠Path parameter

ID of the User.

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send admin-user-sign-out-2026-10-08 in this header.

One of the following:
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"output-128k-2025-02-19"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"ce-plugins-2026-09-01"
"spend-limit-reads-2026-09-26"
"telemetry-destinations-2026-08-11"
"webhooks-2026-10-07"
"admin-user-sign-out-2026-10-08"
"message-threads-2026-08-12"
"analytics-usage-cost-2026-08-24"
"experimental-claude-tag-2026-10-21"
"ce-claude-code-managed-settings-2026-10-06"
"user-profiles-billing-2026-10-01"
"message-batches-2024-09-24"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"prompt-caching-2024-07-31"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"pdfs-2024-09-25"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"token-counting-2024-11-01"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"token-efficient-tools-2025-02-19"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"files-api-2025-04-14"⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/files#migrate-from-files-api-2025-04-14
"extended-cache-ttl-2025-04-11"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"skills-2025-10-02"⁠Deprecated
Sending this value selects the beta response shapes. Removing it moves you to the current shapes, so follow the migration steps: https://platform.claude.com/docs/en/build-with-claude/skills-guide#migrate-from-skills-2025-10-02
"cache-diagnosis-2026-04-07"⁠Deprecated
This value is no longer needed. Remove it from your requests.
"ce-user-management-2026-07-13"⁠Deprecated
This value is no longer needed. Remove it from your requests.
Returns
beta_organization_user: object{ type: "user", id, added_at, 3 more }
Errors

Any method can also return the general HTTP errors.

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

error code cannot_sign_out_primary_ownerHTTP status 400

The member is the organization's primary owner, whom no API key or token can sign out.

error code cannot_sign_out_selfHTTP status 400

The member is the user the API key or token belongs to.

error code organization_not_enrolled_in_betaHTTP status 400

The beta that the endpoint requires is not enabled for the organization. The message names the beta value.

error code cannot_sign_out_managed_memberHTTP status 403

The member has the managed role, and this API key or token cannot sign them out. The error message says which keys and tokens can.

error code cannot_sign_out_membership_adminHTTP status 403

The member is a membership admin, and the person the API key or token belongs to is not allowed to sign out membership admins.

error code cannot_sign_out_ownerHTTP status 403

The member is an owner or has owner permissions, and this API key or token cannot sign them out. In a Claude Enterprise organization, an API key with the write:members scope can.

error code cannot_sign_out_privileged_memberHTTP status 403

This OAuth token cannot sign out a membership admin or a member whose roles grant owner, user management, or identity and access management.

error code sandbox_egress_restrictedHTTP status 403

The request came from a Claude sandbox with restricted network access, which is not allowed to make this request. Send it from outside the sandbox, or from a sandbox with unrestricted network access.

登出用户
ant beta:organization:users sign-out \
  --user-id user_id
Returns Examples
Response 200
{
  "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "user@emaildomain.com",
  "name": "Jane Doe",
  "role": "admin",
  "type": "user"
}