Skip to main content
POST
Create Knowledge Base
Changes state - verify before retry 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

Knowledge base name, at most 150 characters and not blank.

Maximum string length: 150
Pattern: \S
Example:

"Product Documentation"

Response

Knowledge base created successfully.

success
enum<boolean>
required
Available options:
true
error
enum<boolean>
required
Available options:
false
statusCode
integer
required
Example:

201

message
string
required
Example:

"Success"

data
object
required
timestamp
string<date-time>
required