---
title: "List the members of a workspace"
method: GET
path: "/v1/workspaces/{workspace_id}/members"
tags: ["Workspaces"]
---

# List the members of a workspace

`GET /v1/workspaces/{workspace_id}/members`

## Request

- Base URL: `https://api.stacksync.com`
- URL: `https://api.stacksync.com/v1/workspaces/{workspace_id}/members`
- Auth: HTTP bearer

The people of the workspace with their role, and its groups with their members: the user_id and group_id an access grant names its principal by. Pending invitations are not members yet.

## Path parameters

- `workspace_id` integer, required

## Response `200`

OK

- WorkspaceMembers
  - `users` WorkspaceMember[], required
    - `user_id` integer, required
    - `email` string, required
    - `firstname` string, nullable, required
    - `lastname` string, nullable, required
    - `role` 'viewer' | 'editor' | 'owner', required
  - `groups` WorkspaceGroup[], required
    - `group_id` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `member_user_ids` integer[], required

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

[API](https://skmtc.dev/stacksync/apis/stacksync-api.md) - [All operations](https://skmtc.dev/stacksync/apis/stacksync-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stacksync/apis/stacksync-api/revisions/21f4ba4b214e?raw)