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.

Intelligence

Ask

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

Search

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

Files

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

Facets

Define classification trees, classify files, set attribute values, and read structured metadata. 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.

Document processing

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

Administration

API Keys

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