Knowledge Bases

Knowledge Bases are collections of reference documents that your workflows can search at runtime. Use them for static material that agents need to look up — product documentation, policy content, FAQ entries, support articles, and similar.

How they differ from Memory

	Memory	Knowledge Bases
Content source	Extracted from agent interactions	Manually added documents
Deduplication	Automatic — new facts supersede old ones	None — all entries are kept
Search	Semantic similarity	Keyword matching
Best for	Facts that change over time	Static reference material

API Endpoints

Knowledge bases

Method	Path	Description
`GET`	`/workspaces/:wId/knowledge`	List all knowledge bases
`POST`	`/workspaces/:wId/knowledge`	Create a knowledge base
`GET`	`/workspaces/:wId/knowledge/:id`	Get a knowledge base
`PATCH`	`/workspaces/:wId/knowledge/:id`	Update name or description
`DELETE`	`/workspaces/:wId/knowledge/:id`	Delete base and all its entries

Entries

Method	Path	Description
`GET`	`/workspaces/:wId/knowledge/:id/entries`	List entries (paginated)
`POST`	`/workspaces/:wId/knowledge/:id/entries`	Add an entry
`DELETE`	`/workspaces/:wId/knowledge/:id/entries/:eId`	Remove an entry
`POST`	`/workspaces/:wId/knowledge/:id/search`	Search entries

Adding entries

POST /workspaces/:wId/knowledge/:id/entries
 
{
  "content": "Refunds are processed within 5–7 business days.",
  "metadata": { "source": "refund-policy-v3", "page": 2 }
}

Entries are immutable after creation. To update content, delete and re-add the entry.

Searching a knowledge base

POST /workspaces/:wId/knowledge/:id/search
 
{ "query": "refund policy", "limit": 10 }

Returns matching entries ranked by relevance.

Using knowledge in workflows

Add a Retriever node to your workflow and point it at a knowledge base. The node searches at runtime and injects the results into subsequent nodes as context.

{
  "knowledgeBaseId": "kb_abc123",
  "query": "{{input.question}}",
  "topK": 5
}

Knowledge bases are shared across all workflows in the workspace — one base can serve many workflows.

Knowledge Bases

On this page