Update User

post/v1/organizations/users/{user_id}

Update User

Path ParametersExpand Collapse

user_id: string

ID of the User.

Body ParametersExpand Collapse

role: "user" or "developer" or "billing" or "claude_code_user"

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

Accepts one of the following:

"user"

"developer"

"billing"

"claude_code_user"

ReturnsExpand Collapse

User = object { id, added_at, email, 3 more }

id: string

ID of the User.

added_at: string

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

formatdate-time

email: string

Email of the User.

name: string

Name of the User.

role: "user" or "developer" or "billing" or 2 more

Organization role of the User.

Accepts one of the following:

"user"

"developer"

"billing"

"admin"

"claude_code_user"

type: "user"

Object type.

For Users, this is always "user".

Accepts one of the following:

"user"

Update User

curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
    -H 'Content-Type: application/json' \
    -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY" \
    -d '{
          "role": "user"
        }'

Response 200

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "[email protected]",
  "name": "Jane Doe",
  "role": "user",
  "type": "user"
}

Returns Examples

Response 200

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "[email protected]",
  "name": "Jane Doe",
  "role": "user",
  "type": "user"
}

Update User

post/v1/organizations/users/{user_id}

Update User

Path ParametersExpand Collapse

user_id: string

ID of the User.

Body ParametersExpand Collapse

role: "user" or "developer" or "billing" or "claude_code_user"

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

Accepts one of the following:

"user"

"developer"

"billing"

"claude_code_user"

ReturnsExpand Collapse

User = object { id, added_at, email, 3 more }

id: string

ID of the User.

added_at: string

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

formatdate-time

email: string

Email of the User.

name: string

Name of the User.

role: "user" or "developer" or "billing" or 2 more

Organization role of the User.

Accepts one of the following:

"user"

"developer"

"billing"

"admin"

"claude_code_user"

type: "user"

Object type.

For Users, this is always "user".

Accepts one of the following:

"user"

Update User

curl https://api.anthropic.com/v1/organizations/users/$USER_ID \
    -H 'Content-Type: application/json' \
    -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY" \
    -d '{
          "role": "user"
        }'

Response 200

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "[email protected]",
  "name": "Jane Doe",
  "role": "user",
  "type": "user"
}

Returns Examples

Response 200

{
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "[email protected]",
  "name": "Jane Doe",
  "role": "user",
  "type": "user"
}