Skip to main content
POST
Create a knowledge base item by providing text content directly in the request. This is ideal for when you have structured text content that you want to make searchable for your AI agents.

Headers

string
required
Your API key for authentication.
string
required
Must be application/json for text-based knowledge base items.

Body Parameters

string
default:"text"
required
Must be "text" for text-based knowledge base items.
string
required
Name for the knowledge base item.
string
Optional description of the knowledge base item content.
string
required
Text content to be stored in the knowledge base item (maximum 1MB).

Response

object
The created knowledge base item object.
string
Unique identifier for the knowledge base item.
string
Name of the knowledge base item.
string
Description of the knowledge base item (if provided).
string
Current status: "PROCESSING", "COMPLETED", "FAILED", or "DELETED".
string
Will be "TEXT" for text-based knowledge base items.
string
ISO timestamp of creation.
string
ISO timestamp of last update.
string
Error message if status is "FAILED".
null
Will be null on successful creation.

Docs for agents: llms.txt