Skip to main content

Collections

The containers that hold your documents — create, inspect, rename, and delete them.

Create a collection#

Make a new collection inside a project.

A collection is the unit you upload documents into and query against. Each collection belongs to one project. Defaults for chunking and embedding model can be overridden at create time and changed later.

dewey collections create my-docs

# my-docs (col_xyz123)

Response

{
  "id": "col_xyz123",
  "projectId": "proj_abc",
  "name": "my-docs",
  "visibility": "private",
  "chunkSize": 1200,
  "chunkOverlap": 200,
  "embeddingModel": "text-embedding-3-large",
  "enableSummarization": true,
  "enableCaptioning": false,
  "enableDeduplication": true,
  "enableReranking": true,
  "createdAt": "2026-05-14T18:21:09.412Z"
}

See also

List collections#

Enumerate every collection in your project.

Returns every collection your API key has access to. If you don't know your project ID, pull it from the first collection's `projectId` field.

dewey collections list

# my-docs        col_xyz123  42 docs   private
# research-papers col_abc456  118 docs  public

See also

Inspect a collection#

Fetch one collection plus its stats — size, status counts, claim and contradiction state.

Use `get` for the collection object and `stats` for the operational view: document counts by status, storage size, claim and contradiction run state. Call both when populating an admin or health UI.

dewey collections get my-docs
dewey collections stats my-docs

Response

{
  "docCount": 42,
  "storageBytes": 18472331,
  "dbBytes": 4192012,
  "statusCounts": {
    "ready": 40,
    "processing": 1,
    "error": 1
  },
  "claimRun": { "status": "completed", "updatedAt": "..." },
  "contradictionRun": { "status": "idle" }
}

See also

Rename or update a collection#

Change name, visibility, description, chunking, embedding model, or which AI features are enabled.

Every field is optional — pass only what you want to change. Changing chunk size or embedding model does not re-embed existing documents; trigger that explicitly with `recomputeSummaries` / `recomputeClaims` afterwards if needed.

dewey collections update my-docs --name "Quarterly reports" --visibility public

See also

Delete a collection#

Permanently remove a collection and all its documents.

Hard delete. Documents, sections, chunks, embeddings, and claim/contradiction history are removed. There is no undo.

dewey collections delete my-docs