---
title: "Update Organization Member Role"
method: PATCH
path: "/api/v1/organizations/members/{user_id}"
tags: ["Team Management"]
---

# Update Organization Member Role

`PATCH /api/v1/organizations/members/{user_id}`

Updates an organization member's role. Accepts either the coarse `role` (admin/viewer) or a `role_id` — a system role or one of your organization's custom roles (see `GET /api/v1/roles`); provide exactly one. Requires a global API key. Cannot modify the API key's owning user or the organization owner. Cannot demote the last remaining admin.

## Request body

- UpdateOrgMemberRoleRequest — Request body for updating an organization member's role. Provide exactly one of `role` or `role_id`.
  - `role` 'admin' | 'viewer' — Coarse role to assign. Mutually exclusive with `role_id`.
  - `role_id` string — Assign any role by ID — a system role or one of your organization's custom roles (see `GET /api/v1/roles`). Mutually exclusive with `role`. Returns 404 if the role does not exist or belongs to another organization. System role IDs are GUID-shaped sentinels (e.g. `00000000-0000-0000-0000-000000000001`), not RFC 4122 UUIDs.

## Response `200`

Member role updated successfully

- object
  - `success` boolean, required
  - `member` object, required
    - `user_id` string, uuid, required — Unique identifier of the user
    - `org_id` string, uuid, required — Unique identifier of the organization
    - `role` string, required — Slug of the assigned role (e.g. 'admin', 'viewer', or a custom role's slug)
    - `role_id` string, required — ID of the assigned role (a system role ID or a custom role ID)

## Other responses

- `400` — Bad request - Invalid body or path parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Not a global key, self-modification, or owner modification
- `404` — Not found - Organization member does not exist, or the requested `role_id` does not exist in your organization
- `409` — Conflict - Cannot demote the last remaining admin
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/revisions/6c5d71622cb9/schema)