📄 claude/api/admin-api/users/remove-user

File: remove-user.md | Updated: 11/15/2025

Source: https://docs.claude.com/en/api/admin-api/users/remove-user

Agent Skills are now available! Learn more about extending Claude's capabilities with Agent Skills .

Claude Docs home pagelight logodark logo

US

English

Search...

Ctrl K

Search...

Navigation

Organization Member Management

Remove User

Home Developer Guide API Reference Model Context Protocol (MCP) Resources Release Notes

cURL

cURL

Copy

curl --request DELETE "https://api.anthropic.com/v1/organizations/users/user_01WCz1FkmYMm4gnmykNKUu3Q" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

200

4XX

Copy

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "type": "user_deleted"
}

DELETE

/

v1

/

organizations

/

users

/

{user_id}

cURL

cURL

Copy

curl --request DELETE "https://api.anthropic.com/v1/organizations/users/user_01WCz1FkmYMm4gnmykNKUu3Q" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

200

4XX

Copy

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "type": "user_deleted"
}

Headers

x-api-key

string

required

Your unique Admin API key for authentication.

This key is required in the header of all Admin API requests, to authenticate your account and access Anthropic's services. Get your Admin API key through the Console .

anthropic-version

string

required

The version of the Claude API you want to use.

Read more about versioning and our version history here .

Path Parameters

user_id

string

required

ID of the User.

Response

200

application/json

Successful Response

id

string

required

ID of the User.

Examples:

"user_01WCz1FkmYMm4gnmykNKUu3Q"

type

enum<string>

default:user_deleted

required

Deleted object type.

For Users, this is always "user_deleted".

Available options:

| Title | Const | | --- | --- | | Type | user_deleted |

Was this page helpful?

YesNo

Update User Get Invite

Assistant

Responses are generated using AI and may contain mistakes.