Skip to main content
POST
Create Knowledge Base
Changes state - verify before retry
v1 only. Knowledge bases are available on the /v1 API. There is no legacy unversioned equivalent.
A knowledge base is a named collection of your own content that an agent can draw on to answer questions accurately. Create one knowledge base per topic or product area, then attach it to the agents that should use it.

When to use this

Use this endpoint to spin up a knowledge base before uploading documents to it - for example, one knowledge base per product line, or one per customer in a multi-tenant setup. The name must be unique within your workspace.

Minimal request

Verify and continue

Store the returned kb_ ID, list knowledge bases to confirm the record, populate content through the supported dashboard ingestion flow, then attach the ID to an agent version with knowledge_base_ids. If creation times out, list by name before retrying so you do not create a duplicate.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Name of the knowledge base (must be unique within the workspace)

Maximum string length: 150
Example:

"Product Documentation"

Response

Knowledge base created successfully.

id
string
required

Signed knowledge base ID.

Example:

"kb_abc123"

name
string
required
Maximum string length: 150
Example:

"Loan FAQ"

created_at
string<date-time>
updated_at
string<date-time>