Claude Platform Docs

Users

List Users
beta.organization.users.list(**kwargs) -> SyncPage[BetaOrganizationUser]
GET/v1/organizations/users

List the organization's members.

Get User
beta.organization.users.retrieve(user_id) -> BetaOrganizationUser
GET/v1/organizations/users/{user_id}

Retrieve a member of the organization by user ID.

Update User
beta.organization.users.update(user_id, **kwargs) -> BetaOrganizationUser
POST/v1/organizations/users/{user_id}

Update a member's organization role.

Remove User
beta.organization.users.remove(user_id) -> UserRemoveResponse
DELETE/v1/organizations/users/{user_id}

Remove a member from the organization.

Models
class BetaOrganizationUser: type: "user"; id; added_at; ... # 3 more
type: Literal["user"]

Object type.

For Users, this is always "user".

defaultuser
id: str

ID of the User.

added_at: datetime

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

formatdate-time
email: str

Email of the User.

name: str

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"
class UserRemoveResponse: type: "user_deleted"; id
type: Literal["user_deleted"]

Deleted object type.

For Users, this is always "user_deleted".

defaultuser_deleted
id: str

ID of the User.