Skip to main content
GET
Retrieve a document collection

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <token>. The token is either a user token / OAuth access token, or a service-account API key (cfk_...). A key is valid on every endpoint and acts as its service account, an organization member with per-store permissions. Refused keys answer 403 with Invalid API key., API key revoked., API key expired. or API key disabled..

Path Parameters

project_id
string<uuid>
required

UUID of the project

collection_id
string<uuid>
required

Response

Successful response

A named grouping of documents within a project. Membership is the Document.collection foreign key (single collection per document); a mirrored ["tag", slug] pair is also kept on each document's metadata so the retrieval/extraction layers can scope to a collection.

name
string
required

Human-readable label (editable).

id
string<uuid>
read-only
slug
string
read-only

Stable identifier documents are linked by. Derived from name at creation and immutable afterwards (renaming changes only name).

document_count
integer
read-only

Number of active documents in this collection (server-annotated).

created_at
string<date-time>
read-only
updated_at
string<date-time>
read-only