---
title: "Change a workspace member's role"
method: POST
path: "/api/v1/account/workspace-members/{memberId}/role"
tags: ["Account"]
---

# Change a workspace member's role

`POST /api/v1/account/workspace-members/{memberId}/role`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/account/workspace-members/{memberId}/role`
- Auth: HTTP bearer

Sets the member to `owner`, `admin` or `member`. Only a workspace Owner or Admin can, and only an Owner can touch an owner's role.

## Path parameters

- `memberId` string, required

## Headers

- `X-Dotsy-Workspace` string

## Request body

- UpdateWorkspaceMemberRoleRequest
  - `role` 'owner' | 'admin' | 'member', required: The new role. Only an Owner can make someone an owner or change an owner's role, and a workspace always keeps at least one owner.

## Response `200`

The role was changed.

- object
  - `ok` true, required

## Other responses

- `400`: `invalid_body`: send `{ role: 'owner' | 'admin' | 'member' }`, or the change was refused (for example, the last owner can't be demoted).
- `401`: Missing or invalid credentials.
- `403`: `workspace_admin_required`: only a workspace Owner or Admin can change roles.

---

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