---
title: "List workspace-scoped documents (cursor-paginated)"
method: GET
path: "/workspaces/{workspaceId}/documents"
tags: ["Workspace"]
---

# List workspace-scoped documents (cursor-paginated)

`GET /workspaces/{workspaceId}/documents`

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of document summaries in the canonical list envelope.

- object — The canonical v2 list envelope. Every list endpoint returns this shape; per-endpoint `items` element types (and documented extras like `total`) are declared on each operation.
  - `object` 'list', required
  - `items` DocumentSummary[], required — The page of objects. Element type is per-endpoint.
    - `object` 'document', required
    - `id` string, uuid, required
    - `documentId` string, uuid, required — Legacy alias of `id` — kept for pre-restructure consumers.
    - `filename` string, required — Last segment of the VFS path — the user-facing filename.
    - `vfsPath` string, required
    - `kind` string, required
    - `status` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable, required — Cursor for the next page; `null` means this is the last page.
  - `url` string, required — The path this list was fetched from (query string excluded).

## Other responses

- `404` — WORKSPACE_NOT_FOUND.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)