Add text or a .txt/.md file to the knowledge base

POST 
/api/v1/chatbots/:chatbotId/text

Adds text or Markdown straight into the chatbot's knowledge base — no file upload needed. Send a single text string (with an optional fileName) or a batch of items (for example curated question/answer pairs). Each entry becomes its own searchable, listable, deletable knowledge source. Processing is synchronous — the response reports per-entry results. Long entries are split automatically. Required scope: documents:write.

Request

Responses

200

All entries were added.

207

Partial success — some entries were added and some failed (see documents[].success).

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

413

An entry or the batch exceeds the size limit, or the account storage limit.

429

Too Many Requests — rate limit exceeded

500

Every entry failed to be added (see documents[].error for per-entry reasons).