---
title: "Update Member Role"
method: PATCH
path: "/api/v1/workspace/members/{user_id}/role"
tags: ["workspace"]
---

# Update Member Role

`PATCH /api/v1/workspace/members/{user_id}/role`

Update a workspace member's role. Requires workspace admin.

Can change between 'writer' and 'reader' roles. Cannot change your own role.

## Path parameters

- `user_id` string, uuid, required

## Request body

- MemberRoleUpdateRequest — Request model for updating a member's workspace role.
  - `workspace_role` 'writer' | 'reader', required — Role within a workspace determining permission level. WRITER = can edit workspace_write projects READER = can only view workspace projects

## Response `200`

Successful Response

- WorkspaceMemberResponse — Response model for a workspace member.
  - `id` string, uuid, required
  - `display_name` string, nullable
  - `email` string, required
  - `workspace_role` 'writer' | 'reader', required — Role within a workspace determining permission level. WRITER = can edit workspace_write projects READER = can only view workspace projects
  - `is_workspace_admin` boolean, required
  - `avatar_color` string, nullable
  - `used_enrichment_credits` integer
  - `created_at` string, date-time, nullable
  - `last_active_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/revisions/0c94a4b5a00e/schema)
