---
title: "List the workspace's active members"
description: Returns every active member of the workspace.
api_method: GET
api_path: "/v1/workspaces/{workspaceId}/members"
canonical_url: https://wiblo.app/docs/developers/api/members/list-workspace-members
last_updated: 2026-08-03T21:24:33+02:00
md_url: https://wiblo.app/docs/developers/api/members/list-workspace-members.md
---

# List the workspace's active members

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

Returns every active member of the workspace. Available to any active member of the same workspace; cross-tenant probes collapse onto the resolver's `WORKSPACE_NOT_FOUND` 404. RLS hides archived rows. With `?include=archived`, owners and admins additionally receive the workspace's archived members (via the owner/admin-gated `list_archived_members` read lane) appended after the active roster — rows are distinguished by `archived_at`. The param is silently ignored for member-role callers, mirroring `listWorkspaces`. `MemberResponse.email` reflects `workspace_members.email` exactly — never `auth.users.email`. Per-user rate-limited at 60/60s.

## Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `workspaceId` | `string` | Yes |  |

## Query parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `include` | `"archived"` | No | When set to `archived`, owners and admins also receive archived member rows (appended after the active roster). Ignored for member-role callers. |

## Request

**curl**

```bash
curl https://api.wiblo.app/v1/workspaces/{workspaceId}/members \
  -H "Authorization: Bearer $WIBLO_TOKEN"
```

**TypeScript**

```ts
import { createSdk, listWorkspaceMembers } from "@workspace/sdk"

const sdk = createSdk({ baseUrl: "https://api.wiblo.app" })

const { data, error } = await listWorkspaceMembers({
  client: sdk,
  path: { workspaceId: "..." },
})
```

## Responses

**`200`** — The active members of the workspace. Returns `MemberListResponse`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `members` | `array<MemberResponse>` | Yes |  |

**`401`** — No valid Supabase session cookie was present. Returns `ApiErrorEnvelope`.

**`404`** — Caller has no active membership in the workspace, or the workspace does not exist (`WORKSPACE_NOT_FOUND`). Both cases share the envelope to avoid leaking existence. Returns `ApiErrorEnvelope`.

**`422`** — Path param failed UUID validation (`INVALID_PARAMS`). Returns `ApiErrorEnvelope`.

**`429`** — Rate limit exceeded. The body's `error.code` is `RATE_LIMITED` and `error.details.retry_after` is the same number of seconds as the `Retry-After` header. Returns `ApiErrorEnvelope`.

### The MemberResponse object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes |  |
| `role` | `"owner" \| "admin" \| "member"` | Yes |  |
| `name` | `string` | Yes |  |
| `email` | `string \| null` | Yes |  |
| `avatar_url` | `string \| null` | Yes |  |
| `accent_hue` | `"red" \| "coral" \| "orange" \| "green" \| "teal" \| "blue" \| ...` | Yes | The member's stored monogram key; `null` means the tile derives its colour from the hash. Distinct from the user profile's accent_hue, which only seeds this at workspace creation. |
| `linked_user_id` | `string \| null` | Yes |  |
| `linked_at` | `string \| null` | Yes |  |
| `archived_at` | `string \| null` | Yes |  |
| `created_at` | `string` | Yes |  |
| `updated_at` | `string` | Yes |  |