Skip to main content
ZeroWidthdocs
Get started

POST/1.0/knowledge-bases

Creates an empty knowledge base. Required scope: workbench:knowledge_bases:write (scopes reference).

Request body

namestringRequired

1–200 characters.

descriptionstring

Optional description shown in Workbench.

recipestring

How content is processed. Defaults to docs.

  • docs — reference material an agent searches at runtime (chunk + embed).
  • tabular — spreadsheet-style data queried with SQL.
  • graph — docs processing plus entity/relationship extraction.

Response

201 with the created knowledge base. It starts empty — add content with POST /1.0/knowledge-bases/:id/documents, then attach it to an agent in the Workbench editor.

Returns 402 plan_limit when the workspace is at its knowledge-base count limit for its plan.

1 min read