Skip to main content
POST
/
v1
/
organizations
/
users
/
{user_id}
cURL
curl "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" \
  --data '{
    "role": "user"
  }'
{
  "added_at": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "id": "<string>",
  "name": "<string>",
  "role": "user",
  "type": "user"
}

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.

Body

application/json
​
role
enum<string>
required

New role for the User. Cannot be "admin".

Available options:
user,
developer,
billing,
claude_code_user
Examples:

"user"

"developer"

"billing"

"claude_code_user"

Response

Successful Response

​
added_at
string<date-time>
required

RFC 3339 datetime string indicating when the User joined the Organization.

Example:

"2024-10-30T23:58:27.427722Z"

​
email
string
required

Email of the User.

Example:

"user@emaildomain.com"

​
id
string
required

ID of the User.

Example:

"user_01WCz1FkmYMm4gnmykNKUu3Q"

​
name
string
required

Name of the User.

Example:

"Jane Doe"

​
role
enum<string>
required

Organization role of the User.

Available options:
user,
developer,
billing,
admin,
claude_code_user
Examples:

"user"

"developer"

"billing"

"admin"

"claude_code_user"

​
type
enum<string>
default:user
required

Object type.

For Users, this is always "user".

Available options:
user
Allowed value: "user"