---
title: "Add Or Update Users Workspaces"
method: PATCH
path: "/v1/admin/workspaces/{workspace_uuid}/users"
tags: ["beta.admin.workspaces"]
---

# Add Or Update Users Workspaces

`PATCH /v1/admin/workspaces/{workspace_uuid}/users`

Add or update Workspace members.

## Path parameters

- `workspace_uuid` string, uuid, required — Workspace ID.

## Request body

- WorkspaceMemberIN
  - `members` WorkspaceMemberSingleIN[], nullable — Workspace members to add or update.
    - `role_names` string[], nullable — Simplified role names to assign. Mutually exclusive with 'roles'.
    - `roles` union — Role values to assign. Mutually exclusive with 'role_names'.
      - WorkspaceRole[]
      - StaticWorkspaceRoles[]
    - `role_name` 'billing' | 'user' | 'contributor' | 'dev' | 'dev_contributor' | 'mistral_code_user' | 'cloud_user' | 'workspace_contributor' | 'workspace_admin' | 'observability_viewer' | 'workflow_executor', nullable — Deprecated single role name, kept for backward compatibility. Mutually exclusive with 'role'.
    - `role` union — Deprecated legacy single role value, kept for backward compatibility. Mutually exclusive with 'role_name'.
      - 'A' | 'M'
      - 'd7ea77c5-9260-41d0-ab26-52b5add3ee56' | '48436751-ee56-44bd-8a2d-712233977821' | '375cd0db-3bbe-4b79-80f3-954ccf04f3d1' | '578584f1-4319-4c88-9948-38a5184483b6' | 'd79b3027-4eb2-4521-8722-825acfee7d8b' | '252a0825-40b9-4b98-be80-7658956f13e9' | '17aa61c5-1c61-477e-a40a-e52c8ccd74b9' | 'b23cd6e0-91cd-4a8a-9869-b30366bf3966' | '731eb2be-a74f-4070-b797-35bf7009e553' | 'ff86d432-7f27-47f8-b02f-b5c102ef6a55' | '0f9acbf6-93b5-42c7-a227-fc7652755f65' | 'b23cd6e0-91cd-4a8a-9869-b30366bf3966'
    - `user_uuid` string, uuid, required — User ID of the Workspace member.

## Response `200`

OK

- AddOrUpdateUsersToWorkspaceOUT
  - `added_members_count` integer, required — Number of users added to the Workspace.
  - `updated_members_count` integer, required — Number of Workspace members updated.

## Changes

- **2026-07-26** `933c4ebdcd72` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/admin/workspaces/:workspace_uuid/users/patch.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)