---
title: "Get Workspace Users"
method: GET
path: "/api/workspace/{workspace_ext_id}/users"
tags: ["workspace"]
---

# Get Workspace Users

`GET /api/workspace/{workspace_ext_id}/users`

Retrieve users with access to a specific workspace.
RLS handles access control: members can view private workspaces,
anyone can view public workspaces.

## Path parameters

- `workspace_ext_id` string, required

## Response `200`

Successful Response

- WorkspaceUserResponse[]
  - `user` UserResponse, required — Standard user representation used across all endpoints. Used for: login response, workspace users, contacts (when registered).
    - `external_id` string, required
    - `email` string, required
    - `given_name` string, required
    - `family_name` string, required
    - `picture` string, nullable
    - `encryption_public_key` string, required
  - `role` 'owner' | 'collaborator' | 'guest', required — Role of a user within a workspace.
  - `joined_at` string, date-time, required
  - `conversation_count` integer
  - `document_count` integer

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-17** `b91e4b449d56` — 5 breaking, 1 warning, 5 info
  - removed the required property `items/email` from the response with the `200` status
  - removed the required property `items/encryption_public_key` from the response with the `200` status
  - removed the required property `items/external_id` from the response with the `200` status
  - removed the required property `items/family_name` from the response with the `200` status
  - …7 more
- **2025-12-25** `aa4b06f8dede` — 3 breaking, 5 info
  - removed the required property `items/last_name` from the response with the `200` status
  - removed the required property `items/name` from the response with the `200` status
  - removed the required property `items/user_ext_id` from the response with the `200` status
  - added the optional property `items/picture` to the response with the `200` status
  - …4 more
- **2025-10-28** `849d5e8732f6` — 1 breaking, 3 info
  - removed the required property `items/user_email` from the response with the `200` status
  - added the required property `items/email` to the response with the `200` status
  - added the required property `items/last_name` to the response with the `200` status
  - added the required property `items/name` to the response with the `200` status

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/workspace/:workspace_ext_id/users/get.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/1f956ac3d1c1/schema)