Update User

Update a member's organization role.

post/v1/organizations/users/{user_id}?beta=true

Path parameters

user_idstring required

ID of the User.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Request body

role'billing' | 'claude_code_user' | 'developer' | 'managed' | 'user' required

New role for the User.

The accepted values depend on the organization type. Console and API organizations accept user, developer, billing, and claude_code_user; admin cannot be assigned through the API. Claude Enterprise organizations accept user and managed.

Example request

{
  "role": "user"
}

Response

Successful Response

added_atstring date-time required

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

emailstring required

Email of the User.

idstring required

ID of the User.

namestring required

Name of the User.

type'user' required

Object type.

For Users, this is always "user".

Example response

{
  "added_at": "2024-10-30T23:58:27.427722Z",
  "email": "user@emaildomain.com",
  "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
  "name": "Jane Doe"
}