---
title: "Change a member's role"
method: PATCH
path: "/v1/organization/members/{memberId}"
---

# Change a member's role

`PATCH /v1/organization/members/{memberId}`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/organization/members/{memberId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

An administrator changes another person's role. Self role changes and demoting the last administrator are refused, including concurrent requests. Existing sessions and grants are narrowed on their next request.

## Path parameters

- `memberId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

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

## Response `200`

Change a member's role

- object
  - `completed` true, required
  - `id` union, required
    - string
    - string
  - `project` string

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `404`: Problem document. Possible codes at this status: not_found.
- `409`: Problem document. Possible codes at this status: idempotency_key_reused, state_conflict.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)