---
title: "List workspace members"
method: GET
path: "/workspaces/{workspaceId}/members"
tags: ["Workspaces"]
---

# List workspace members

`GET /workspaces/{workspaceId}/members`

## Request

- Base URL: `https://app.flora.ai/api/v1`
- URL: `https://app.flora.ai/api/v1/workspaces/{workspaceId}/members`
- Auth: HTTP bearer

Returns one page of members for a workspace the authenticated credential can access — email, display name, and role for each. Use meta.next_cursor to fetch subsequent pages, or pass email to look up one person. Lets an integration acting for the workspace (for example the FLORA Slack agent) tell which of the people it serves hold a FLORA account here. Workspaces the credential cannot read return 403.

## Path parameters

- `workspaceId` string, required: Workspace identifier

## Query parameters

- `limit` integer: Maximum number of results to return
- `cursor` string: Opaque cursor for fetching the next page
- `email` string, email: Return only the member who owns this email address, or no members when nobody who owns it belongs to the workspace. Matching ignores case for addresses stored in lowercase; an address stored with upper case matches only in that casing. At Gmail and Googlemail, dots in the local part are ignored. cursor and limit are ignored, and meta.next_cursor is null.

## Response `200`

Workspace members returned.

- object
  - `workspace_id` string, required: Workspace identifier
  - `members` object[], required
    - `email` string, required: Member email address
    - `name` string, nullable, required: Member display name, when set
    - `role` string, required: Workspace role
    - `joined_at` integer, nullable, required: When the membership was created (ms since epoch), when recorded
  - `meta` object, required
    - `next_cursor` string, nullable, required: Opaque cursor for fetching the next page
    - `total_estimate` integer, nullable: Estimated total matching items

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500
- `503`: 503

## Changes

- **2026-10-28** `a12af1ff589c`: 1 info
  - added the new optional `query` request parameter `email`
- **2026-10-28** `a8351619f225`: 9 warning
  - added the new `not_configured` enum value to the `error/code` response property for the response status `400`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `401`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `402`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `403`
  - …5 more
- **2026-10-16** `e54130373b10`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/changes/workspaces/:workspaceId/members/get.md)

---

[API](https://skmtc.dev/florafauna-ai/apis/flora-ai-api.md) - [All operations](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/revisions/87cfe2c4ac29?raw)