> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dalyenergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Organization User Role

> Change a user's role within an organization

# PATCH /organizations/{organization_id}/users/{user_id}

Reassign the organization-level role for an existing member. Use this to promote or demote users within the organization's role hierarchy.

## Notes

* **Requires `owner` role.** Only organization owners can change user roles. Returns `403` for all other roles.
* Valid roles are: `owner`, `admin`, `member`, `viewer`.
* Returns `422` if the supplied role is not one of the valid options.
* Returns `404` if the target user is not a member of the organization.
* Promoting a user to `owner` automatically grants them `admin`-level workspace access across all workspaces in the organization.

<Warning>
  Promoting a user to `owner` is a powerful action -- it cascades workspace-level admin permissions. Only do this intentionally.
</Warning>

* See [List Organization Users](/api-reference/endpoints/organizations-users) to review current memberships before making changes.