Claude Platform Docs

Users

List Users
client.beta.organization.users.list(query?, options?): Page<BetaOrganizationUser>
GET/v1/organizations/users

List the organization's members.

Get User
client.beta.organization.users.retrieve(userID, options?): BetaOrganizationUser
GET/v1/organizations/users/{user_id}

Retrieve a member of the organization by user ID.

Update User
client.beta.organization.users.update(userID, body, options?): BetaOrganizationUser
POST/v1/organizations/users/{user_id}

Update a member's organization role.

Remove User
client.beta.organization.users.remove(userID, options?): UserRemoveResponse
DELETE/v1/organizations/users/{user_id}

Remove a member from the organization.

Models
interface BetaOrganizationUser { type: "user"; id; added_at; /* 3 more */ }
type: "user"

Object type.

For Users, this is always "user".

defaultuser
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: BetaOrganizationRole

Organization role of the User.

One of the following:
"admin"
"billing"
"claude_code_user"
"developer"
"managed"
"membership_admin"
"owner"
"primary_owner"
"user"
interface UserRemoveResponse { type: "user_deleted"; id }
type: "user_deleted"

Deleted object type.

For Users, this is always "user_deleted".

defaultuser_deleted
id: string

ID of the User.