v2

latestOpenAPI 3.1.02026-07-262937191.0 MB
beta.admin.users

Update User

Update an Organization member's roles and product seats.

patch/v1/admin/users/{user_id}

Path parameters

user_idstring uuid required

User ID.

User ID.

Request body

role_namesstring[] nullable

Simplified role names to assign. Mutually exclusive with 'roles'.

role_name'member' | 'billing_manager' | 'organization_admin' nullable

Deprecated single role name, kept for backward compatibility. Mutually exclusive with 'role'.

subscription_typesstring[] nullable

Product seats to assign to the member.

Response

OK

uuidstring uuid required

Organization member ID.

oid_idstring uuid nullable required

Identity provider ID for the member.

namestring nullable required

Name of the Organization member.

emailstring nullable required

Email address of the Organization member.

is_sso_outsiderboolean nullable

Whether the member is outside the SSO domain.

subscription_typesstring[] nullable

Product seats assigned to the member.

created_atstring date-time required

Date the member was added to the Organization.

Example response

{
  "name": "Alice Martin",
  "email": "alice.martin@example.com",
  "workspaces": [
    {
      "name": "Product Team"
    }
  ]
}