Documents
List documents
Canonical library list. Each row is a ChatAttachment.
GET
List documents (unified, att-centric)
Canonical library list. Each row is a
ChatAttachment — this id is what the unified viewer and the other /attachments/{att_id}/ routes use.
The list is the caller’s organization, plus (on a personal credential only) documents the caller still owns after an org move. An API key stays inside the key’s tenant.
GET /api/v2/documents/ is the older chat-centric list ({id} = Deep Reader chat pk). Prefer this attachment list unless you are driving that older surface.Authorizations
Organisation API key from Settings → API / /api/keys/. The secret is
shown once. Send Authorization: Bearer sk-abacus-…. One active key
per organisation. Ingest (/api/v2/ingest/*) refuses API keys — that
surface is Auth0-only with ingest:read / ingest:write scopes.
Query Parameters
Only docs belonging to this batch id.
Only docs whose home chat is this id.
Filter by whether a schema is pinned.
Sort field (whitelisted).
1-based page number.
Items per page (1-100, default 24).
Filter by status. Omit for 'completed'; pass 'all' to disable.
Available options:
all, completed, failed, pending Case-insensitive file-name substring match.

