Update an organization user's role
Change a member's role in the organization (optionally replacing their additional roles). Requires a user credential (an API key is rejected) that is an Owner or Admin of the organization. Select a client organization with Organization-Id, or omit it for the partner firm team. You cannot change your own membership, only an Owner can change another Owner, and only an Owner can assign the Owner role; each returns 403. A PENDING user has no role to change and returns 409: revoke their invitation and send a new one. Returns 404 if the organization is not accessible; the response is empty on success.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target client organization. Omit to manage the partner firm team when the bearer is an Owner or Admin of exactly one portfolio.
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
Opaque identifier of the user to update. Treat as opaque.
Body
New primary role for the user in the organization.
OWNERADMINMEMBEROptional additional role names to assign alongside the primary role. When provided, replaces the user's current additional roles; omit the field to leave them unchanged, or send an empty list to clear them.
Response
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.
A service this request depends on was unavailable. Retry the request.