> ## 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 Changesets

> List a workspace's changesets by status.

Lists a workspace's changesets, newest first. Filter by status to build a review queue (`status=SUBMITTED`).

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

## Request

<ParamField query="workspaceId" type="string" required>
  The workspace to list (required).
</ParamField>

<ParamField query="status" type="string">
  `DRAFT`, `SUBMITTED`, `APPROVED`, `APPLIED`, `REJECTED`, `WITHDRAWN`, or `CONFLICTED`.
</ParamField>

<ParamField query="limit" type="number">
  Page size.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor.
</ParamField>

## Response

<ResponseField name="changesets" type="object[]">
  Changeset records (see [Get Changeset](/docs/developers/api-reference/instructions/get-changeset)).
</ResponseField>

<ResponseField name="nextCursor" type="string | null">
  Pagination continuation.
</ResponseField>