Knowledge base

The documents the AI is allowed to answer from.

Scope: knowledge_base

A knowledge base holds sources (a file, or a crawled URL), and each source is split into chunks — the passages the retriever matches a question against. Ingestion is asynchronous: add a source, then poll until its status reads ready.

📄️List knowledge bases

Every knowledge base in the account.

📄️Create a knowledge base

Create an empty knowledge base. Counts against the plan's knowledge-base limit.

📄️Get a knowledge base

One knowledge base with its indexing statistics.

📄️Delete a knowledge base

Delete a knowledge base and every source and chunk inside it. Irreversible.

📄️List sources

The sources in a knowledge base, with their ingestion status.

📄️Add a source

Add a source — a URL, or an uploaded file.

📄️Delete a source

Deletes one source and every chunk derived from it.

📄️List indexed chunks

The indexed passages in a knowledge base — literally what the AI can see.