v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB

Members

Update a member

Updates a member of the caller's organization. Today only the role is mutable. The caller must be an admin or owner; owners cannot be demoted via this endpoint. Requires OAuth authentication.

patch/v1/members/{memberId}

Path parameters

memberIdstring required

Membership identifier.

Request body

role'admin' | 'member' required

New role. Owners cannot be changed via this endpoint — owner-transfer happens on the web.

Response

Member with the updated role

status'active' required

Discriminator for confirmed members — the user has accepted their invitation and joined the org.

idstring required

Stable membership identifier. Use this to address the row in update/remove endpoints.

organizationIdstring required

Organization this membership belongs to.

userIdstring required

Identifier of the user the membership represents.

role'owner' | 'admin' | 'member' required

Member's role within the organization.

namestring nullable required

Display name of the user. null if the user hasn't completed onboarding.

emailstring required

User's email address, verified at signup.

imagestring nullable required

User's profile image URL, when set.

joinedAtstring required

ISO-8601 timestamp at which the user joined the organization.