Skip to main content

Overview

Create a new Knowledge Base by uploading documents that your AI agents can use during conversations. A Knowledge Base can contain PDFs, Word documents, text files, and other supported formats.

Prerequisites

  • Bearer token for an authenticated workspace
  • One or more supported documents
  • multipart/form-data request

Request

string
required
Bearer token for authenticated workspace access.
string
required
Unique name of the Knowledge Base.
string
Description of the Knowledge Base.
file[]
required
One or more files to upload. Supports PDF, DOCX, TXT, CSV and other supported document formats.

Response

Request Fields

Response Fields

boolean
Indicates whether the request was successful.
integer
HTTP status code.
string
Response message.
string
Unique identifier of the Knowledge Base.
string
Name of the Knowledge Base.
string
Description of the Knowledge Base.
array
Documents uploaded to the Knowledge Base.
string
Timestamp when the Knowledge Base was created.

Error Handling

Large Knowledge Bases may take a few moments to finish processing before they become available for AI agents.
After creating a Knowledge Base, you can:
  • GET /api/knowledgeBase — View all Knowledge Bases.
  • GET /api/knowledgeBase/{knowledgeBaseId} — Retrieve Knowledge Base details.
  • GET /api/knowledgeBase/{knowledgeBaseId}/documents — View uploaded documents.
  • PUT /api/knowledgeBase/{knowledgeBaseId} — Upload additional documents or update metadata.
  • Attach the Knowledge Base to an AI Agent during agent creation or update.