> ## Documentation Index
> Fetch the complete documentation index at: https://opentrain.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workspaces

> List the instruction workspaces you own or hold a permission on.

Lists every [instruction workspace](/docs/developers/concepts/instruction-manuals) the caller owns or holds an explicit permission on. Cursor-paginated.

**Requirements:** `instructions:read`.

## Request

<ParamField query="cursor" type="string">
  Opaque pagination cursor from a previous response's `nextCursor`.
</ParamField>

## Response

<ResponseField name="workspaces" type="object[]">
  Workspace summaries: `{id, name, manualCount, archivedAt, createdAt, updatedAt}`.
</ResponseField>

<ResponseField name="nextCursor" type="string | null">
  Pass back as `cursor` to fetch the next page; `null` when exhausted.
</ResponseField>