---
title: "Update user role in workspace"
method: PUT
path: "/users/{subOrEmail}"
tags: ["workspaces"]
---

# Update user role in workspace

`PUT /users/{subOrEmail}`

Updates the role of a user in the workspace.

## Path parameters

- `subOrEmail` string, required

## Request body

- object
  - `role` string, required — The new role to assign to the user

## Response `200`

User role updated successfully

- WorkspaceUser — Workspace user
  - `accepted` boolean — Whether the user has accepted the workspace invitation
  - `email` string — Workspace user email
  - `email_verified` boolean — Whether the user's email has been verified
  - `expired` boolean — Whether the invitation has expired
  - `family_name` string — Workspace user family name
  - `given_name` string — Workspace user given name
  - `role` string — Workspace user role
  - `source` 'directory_sync' | 'invitation' | 'domain_capture' — Source of the user provisioning
  - `sub` string — Workspace user identifier

## Other responses

- `400` — Invalid role provided
- `404` — Workspace or user not found

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/revisions/dfa264bc72ee/schema)