---
title: "Change a member's role (role: admin+). An actor may only assign roles below their own rank, and only to members below their own rank; owners may also promote to and demote from owner. Nobody may change their own role, and the org must always retain at least one owner."
method: PATCH
path: "/api/org/members/{userID}"
tags: ["Members"]
---

# Change a member's role (role: admin+). An actor may only assign roles below their own rank, and only to members below their own rank; owners may also promote to and demote from owner. Nobody may change their own role, and the org must always retain at least one owner.

`PATCH /api/org/members/{userID}`

## Request

- Base URL: `https://api.witwiki.app`
- URL: `https://api.witwiki.app/api/org/members/{userID}`
- Auth: HTTP bearer

## Path parameters

- `userID` string, required

## Request body

- object
  - `role` 'owner' | 'admin' | 'member' | 'viewer', required

## Response `200`

Updated member

## Other responses

- `403`: The role ladder does not permit this change
- `404`: No such member in this org
- `409`: The change would leave the org with no owner

---

[API](https://skmtc.dev/witwiki/apis/witwiki-api.md) · [All operations](https://skmtc.dev/witwiki/apis/witwiki-api/llms.txt) · [OpenAPI document](https://skmtc.dev/witwiki/apis/witwiki-api/revisions/cc93279a2dff?raw)