# Update an organization user's role

> PATCH /users/{user_id}

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-an-organization-user-s-role

PATCH /users/{user_id}

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.

Category: Users

Path parameters:
user_id (string, required) - Opaque identifier of the user to update. Treat as opaque.

Request body:
role (PublicUserRoleEnum, required) - New primary role for the user in the organization.
  allowed values: OWNER, ADMIN, MEMBER
additionalRoles (string[]) - Optional 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 statuses: 204, 400, 401, 403, 404, 409, 422, 503

---

Index of every page: https://docs.trykintsugi.com/llms.txt