---
title: "List the workspace's members"
method: GET
path: "/api/v1/account/workspace-members"
tags: ["Account"]
---

# List the workspace's members

`GET /api/v1/account/workspace-members`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/account/workspace-members`
- Auth: HTTP bearer

Everyone in the active workspace, up to 200 people, with their roles. Any member can list.

## Headers

- `X-Dotsy-Workspace` string

## Response `200`

The members.

- WorkspaceMemberList
  - `members` WorkspaceMember[], required
    - `id` string, required: The membership id. Use it as `memberId` in the role and remove operations.
    - `userId` string, required
    - `name` string, nullable, required
    - `email` string, nullable, required
    - `role` 'owner' | 'admin' | 'member', required
    - `createdAt` number, required: When they joined, Unix ms.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You are not a member of this workspace.

---

[API](https://skmtc.dev/dotsy/apis/dotsy-api.md) · [All operations](https://skmtc.dev/dotsy/apis/dotsy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dotsy/apis/dotsy-api/revisions/4272ed3b85d7?raw)