Claude Platform Docs

Remove User

DELETE/v1/organizations/users/{user_id}

Remove a member from the organization.

Path parameters
user_id: string

ID of the User.

Headers
"anthropic-version": optional string

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Returns
type: "user_deleted"

Deleted object type.

For Users, this is always "user_deleted".

defaultuser_deleted
id: string

ID of the User.

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_remove_last_memberHTTP status 400

The user is the organization's only member. Add another member before removing this one.

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 change. Send it from outside the sandbox, or from a sandbox with unrestricted network access.

error code concurrent_membership_changeHTTP status 409

Another change to the organization's members is in progress. Retry the request once it completes.

Remove User
curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
    -X DELETE \
    -H 'anthropic-version: 2026-10-21' \
    -H "Authorization: Bearer $ANTHROPIC_API_KEY"
Returns Examples
Response 200
{
  "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
  "type": "user_deleted"
}