Skip to main content
GET
List workspace-scoped documents (cursor-paginated)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId
string<uuid>
required

Deprecated container id: a legacy workspace id OR a chat-session id (the session-container form is what v2 returns for new agents). Both resolve everywhere this parameter appears.

Query Parameters

cursor
string

Opaque pagination cursor. Pass the nextCursor from the previous page to fetch the next one; omit for the first page.

limit
integer
default:50

Max objects to return per page. Default 50, max 100 (the rows endpoint allows up to 200 and documents its own limit).

Required range: 1 <= x <= 100

Response

A page of document summaries in the canonical list envelope.

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
string
required
Allowed value: "list"
items
object[]
required

The page of objects. Element type is per-endpoint.

nextCursor
string | null
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).