Claude Platform Docs

Déconnecter un utilisateur

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

Déconnecte un membre de Claude partout, sans le retirer de l'organisation. Cela met fin à ses sessions de connexion et supprime ses appareils de confiance partout où il utilise Claude, y compris dans d'autres organisations et sur des forfaits individuels. Cela met également fin aux jetons OAuth qui lui ont été émis pour cette organisation, de sorte que les applications telles que Claude Code doivent se reconnecter.

Un jeton peut mettre jusqu'à une heure à cesser de fonctionner, bien qu'il cesse presque toujours immédiatement. Le membre conserve son rôle et peut se reconnecter immédiatement. Pour l'empêcher de revenir, retirez-le de l'organisation ou, si votre organisation utilise l'authentification unique, bloquez-le dans votre fournisseur d'identité. La déconnexion ne met pas fin aux clés API, aux jetons OAuth qui n'ont pas été émis pour cette organisation, ni aux sessions cloud et routines Claude Code du membre.

Vous ne pouvez pas déconnecter le propriétaire principal de l'organisation ni la personne pour laquelle agit votre clé API ou votre jeton, et une requête visant à déconnecter un autre propriétaire, un membre disposant des autorisations de propriétaire ou un administrateur des membres peut être refusée. Une requête refusée renvoie une erreur 400 ou 403 qui en indique la raison. Si la requête renvoie 503, envoyez-la à nouveau pour terminer ; tout ce qui a déjà pris fin le reste.

Chaque requête doit inclure l'en-tête bêta anthropic-beta: admin-user-sign-out-2026-10-08. Une requête sans cet en-tête renvoie 400. La déconnexion est en bêta pour les organisations Claude Enterprise. Dans une organisation où elle n'est pas activée, une requête renvoie 400 avec le error_code organization_not_enrolled_in_beta. Dans une organisation Claude Enterprise, une clé API nécessite la portée write:members ; une clé qui ne l'a pas reçoit 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.

Déconnecter un utilisateur
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"
}