Claude Platform Docs

Users

List Users
$ ant beta:organization:users list
GET/v1/organizations/users

List the organization's members.

Get User
$ ant beta:organization:users retrieve
GET/v1/organizations/users/{user_id}

Retrieve a member of the organization by user ID.

Update User
$ ant beta:organization:users update
POST/v1/organizations/users/{user_id}

Update a member's organization role.

Remove User
$ ant beta:organization:users remove
DELETE/v1/organizations/users/{user_id}

Remove a member from the organization.

Sign Out User
$ 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.

Sign a member out of Claude everywhere, without removing them from the organization. This ends their sign-in sessions and removes their trusted devices wherever they use Claude, including other organizations and individual plans. It also ends the OAuth tokens issued to them for this organization, so apps such as Claude Code must sign in again.

Models
beta_cannot_sign_out_managed_member_error_details: object{ error_code }
error_code: "cannot_sign_out_managed_member"
beta_cannot_sign_out_membership_admin_error_details: object{ error_code }
error_code: "cannot_sign_out_membership_admin"
beta_cannot_sign_out_owner_error_details: object{ error_code }
error_code: "cannot_sign_out_owner"
beta_cannot_sign_out_primary_owner_error_details: object{ error_code }
error_code: "cannot_sign_out_primary_owner"
beta_cannot_sign_out_privileged_member_error_details: object{ error_code }
error_code: "cannot_sign_out_privileged_member"
beta_cannot_sign_out_self_error_details: object{ error_code }
error_code: "cannot_sign_out_self"
beta_organization_user: object{ type: "user", id, added_at, 3 more }
Errors
"cannot_sign_out_primary_owner"⁠HTTP status 400

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

details: object{ error_code }
error_code: "cannot_sign_out_primary_owner"
"cannot_sign_out_self"⁠HTTP status 400

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

details: object{ error_code }
error_code: "cannot_sign_out_self"
"cannot_sign_out_managed_member"⁠HTTP 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.

details: object{ error_code }
error_code: "cannot_sign_out_managed_member"
"cannot_sign_out_membership_admin"⁠HTTP 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.

details: object{ error_code }
error_code: "cannot_sign_out_membership_admin"
"cannot_sign_out_owner"⁠HTTP 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.

details: object{ error_code }
error_code: "cannot_sign_out_owner"
"cannot_sign_out_privileged_member"⁠HTTP 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.

details: object{ error_code }
error_code: "cannot_sign_out_privileged_member"