---
title: "Change a member's role (owner only)"
method: PATCH
path: "/v1/members/{memberId}"
tags: ["discovery"]
---

# Change a member's role (owner only)

`PATCH /v1/members/{memberId}`

## Request

- Base URL: `https://postbag.dev`
- URL: `https://postbag.dev/v1/members/{memberId}`
- Auth: HTTP bearer

Owner only — an admin cannot promote or demote anyone, including themselves. Cannot demote the organization's last owner (409 last_owner); promote someone else first.

## Path parameters

- `memberId` string, required: The Membership id (not the user id).

## Request body

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

## Response `200`

ok

- Member
  - `id` string, required
  - `user` object, required
    - `id` string, required
    - `name` string, required
    - `email` string, required
  - `role` 'owner' | 'admin' | 'member', required
  - `joined_at` string, required

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Not found
- `409`: Error
- `422`: Error

---

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