Claude Platform Docs

Remove User

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

Remove a member from the organization.

Parameters
--user-id: string⁠Path parameter

ID of the User.

Returns
OrganizationUserRemoveResponse: object{ type: "user_deleted", id }
type: "user_deleted"

Deleted object type.

For Users, this is always "user_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
ant organization:users remove \
  --user-id user_id
Returns Examples
Response 200
{
  "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
  "type": "user_deleted"
}