Skip to main content
All endpoints are under /api/v3/ and require a bearer token. See Authentication for setup. The reference pages in this section are generated from the OpenAPI specification: every parameter, response shape, and error code is documented exactly as the server implements it.

Endpoint families

Search

POST /api/v3/search: Hybrid vector + lexical retrieval with optional reranking. Tutorial

Ask

POST /api/v3/ask: Retrieval-augmented generation: a grounded LLM answer plus its sources, sync or streamed. Tutorial

Files

Upload, list, fetch, update, and delete documents in your workspaces. Tutorial

Parse

POST /api/v3/parse: Convert documents to clean Markdown, synchronously or as an async job. Tutorial

Extract

Pull typed fields from documents using a JSON Schema you provide. Tutorial

Tags

Manage company-wide document tags used to scope search and organise content.

Workspaces

Create and manage workspaces: the access-controlled containers your documents live in.

API Keys

Provision and revoke API keys used to authenticate against the API.