Claude Platform Docs

Disconnetti utente

$ 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.

Disconnetti un membro da Claude ovunque, senza rimuoverlo dall'organizzazione. Questa operazione termina le sue sessioni di accesso e rimuove i suoi dispositivi attendibili ovunque utilizzi Claude, incluse altre organizzazioni e piani individuali. Termina inoltre i token OAuth emessi a suo nome per questa organizzazione, quindi app come Claude Code devono accedere di nuovo.

Un token può impiegare fino a un'ora per smettere di funzionare, anche se quasi sempre smette immediatamente. Il membro mantiene il proprio ruolo e può accedere di nuovo immediatamente. Per tenerlo fuori, rimuovilo dall'organizzazione oppure, se la tua organizzazione usa il single sign-on, bloccalo nel tuo provider di identità. La disconnessione non termina le chiavi API, i token OAuth che non sono stati emessi per questa organizzazione, né le sessioni cloud e le routine di Claude Code del membro.

Non puoi disconnettere il proprietario principale dell'organizzazione né la persona per conto della quale agisce la tua chiave API o il tuo token, e una richiesta di disconnettere un altro proprietario, un membro con autorizzazioni di proprietario o un amministratore dei membri può essere rifiutata. Una richiesta rifiutata restituisce un errore 400 o 403 che ne indica il motivo. Se la richiesta restituisce 503, inviala di nuovo per completarla; tutto ciò che è già stato terminato resta terminato.

Ogni richiesta deve includere l'header beta anthropic-beta: admin-user-sign-out-2026-10-08. Una richiesta senza di esso restituisce 400. La disconnessione è in beta per le organizzazioni Claude Enterprise. In un'organizzazione in cui non è abilitata, una richiesta restituisce 400 con error_code organization_not_enrolled_in_beta. In un'organizzazione Claude Enterprise, una chiave API necessita dello scope write:members; una chiave senza di esso riceve 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.

Disconnetti utente
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"
}