---
title: "Change Member Role"
method: PATCH
path: "/v1/auth/tenants/{tenant_id}/members/{user_id}"
tags: ["auth", "auth"]
---

# Change Member Role

`PATCH /v1/auth/tenants/{tenant_id}/members/{user_id}`

## Request

- Base URL: `https://api.elaan.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elaan.io/v1/auth/tenants/{tenant_id}/members/{user_id}`
- Auth: none declared

Change a member's role (admin+ only; owners only touchable by owners; never
yourself; never *to* owner).

## Path parameters

- `tenant_id` string, required
- `user_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- ChangeMemberRoleRequest: Change an existing member's role. `role` must be admin/member/viewer — owner is rejected (422); ownership isn't assigned via a role change.
  - `role` string, required

## Response `200`

Successful Response

- MemberResponse: One current member of an account (email + role).
  - `user_id` string, required
  - `email` string, required
  - `role` string, required
  - `is_default` boolean, required

## Other responses

- `403`: Not an admin of that tenant, or an admin targeting an owner
- `404`: That person is not a member of this tenant
- `409`: You can't change your own membership from here
- `422`: A role of owner (not assignable via a role change)

---

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