Update a member's role and/or activation status.

PATCH

/v1/organizations/members/{user_id}

• Production
• Staging
• Local

Parameters

Path Parameters

user_id

required

string format: uuid

The UUID of the member to update

Request Body ^required

object

active

Set to true to reactivate a deactivated user. Absent means “don’t change activation status”. false is rejected — use DELETE to deactivate.

boolean | null

roles

Names of the roles to assign (e.g. [“admin”], [“editor”, “viewer”]). Absent means “don’t change roles”.

array | null

Responses

200

Member updated

object

email

required

string

first_name

required

string

icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null

id

required

string format: uuid

last_name

required

string

deactivated_date

string | null format: date-time

joined_date

required

string format: date-time

kind

required

Kind of principal an OrganizationMember represents. Always HUMAN on the /v1/users endpoint today; included on the wire so frontend consumers have a single discriminator regardless of which endpoint surfaced the row.

Wire format is SCREAMING_SNAKE_CASE so these read as constants (HUMAN, SERVICE_ACCOUNT); the DB-side organization_user_kind enum stores the snake_case form ('human', 'service_account') and gets translated by the From<OrganizationUserKind> impl below.

string

Allowed values: HUMAN INTEGRATION SERVICE_ACCOUNT

last_login

string | null format: date-time

roles

required

Array<string>

400

Invalid request

403

Forbidden - insufficient permissions

404

User not found in organization