Create Knowledge Base From Text Endpoint

curl --request POST \
  --url https://api.example.com/v1/knowledge-base/text \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "name": "<string>"
}
'

{
  "id": "<string>",
  "name": "<string>"
}

Knowledge Base

Create Knowledge Base From Text Endpoint

Create a knowledge base document from raw text input.

Request body:

text: Text content for the document (required)
name: Optional document name (auto-generated from first line if not provided)

Returns:

id: Generated document ID
name: Document name

The endpoint will:

Validate the text content
Auto-generate a document name if not provided (uses first line of text)
Store the content in the knowledge base
Return the document ID and name

Error cases:

400: Invalid text (empty, too short, or too large)
401: Invalid authentication
500: Server error

POST

knowledge-base

text

Create Knowledge Base From Text Endpoint

curl --request POST \
  --url https://api.example.com/v1/knowledge-base/text \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "name": "<string>"
}
'

{
  "id": "<string>",
  "name": "<string>"
}

Headers

x-api-key

string | null

API key for authentication

Body

application/json

Model for creating a knowledge base document from text

text

string

required

Text content for the document

Minimum string length: 1

name

string | null

Optional document name (auto-generated if not provided)

Maximum string length: 500

Response

Successful Response

Response after creating a knowledge base document

string

required

name

string

required

Create Knowledge Base From Url Endpoint

Create Knowledge Base From Files

⌘I

Getting Started

Agents

Batch Calling

Voices

Conversations

Payments

Knowledge Base

Webhooks

Workers

Create Knowledge Base From Text Endpoint

Headers

Body

Response