Skip to main content
POST
https://api.bland.ai
/
v1
/
knowledge
/
learn
curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "type": "text",
    "name": "Product Information",
    "description": "Product specifications and features",
    "text": "Our flagship product offers advanced AI capabilities with industry-leading accuracy. It supports multiple languages, real-time processing, and seamless integration with existing systems. The product includes comprehensive APIs, detailed documentation, and 24/7 support."
  }'

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V6U",
    "name": "Product Information",
    "description": "Product specifications and features",
    "status": "PROCESSING",
    "type": "TEXT",
    "created_at": "2025-01-15T11:00:00Z",
    "updated_at": "2025-01-15T11:00:00Z"
  },
  "errors": null
}
Create a knowledge base 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

​
authorization
string
required
Your API key for authentication.
​
content-type
string
required
Must be application/json for text-based knowledge bases.

​
Body Parameters

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

​
Response

​
data
object
The created knowledge base object.
​
data.id
string
Unique identifier for the knowledge base.
​
data.name
string
Name of the knowledge base.
​
data.description
string
Description of the knowledge base (if provided).
​
data.status
string
Current status: "PROCESSING", "COMPLETED", "FAILED", or "DELETED".
​
data.type
string
Will be "TEXT" for text-based knowledge bases.
​
data.created_at
string
ISO timestamp of creation.
​
data.updated_at
string
ISO timestamp of last update.
​
data.error_message
string
Error message if status is "FAILED".
​
errors
null
Will be null on successful creation.
curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "type": "text",
    "name": "Product Information",
    "description": "Product specifications and features",
    "text": "Our flagship product offers advanced AI capabilities with industry-leading accuracy. It supports multiple languages, real-time processing, and seamless integration with existing systems. The product includes comprehensive APIs, detailed documentation, and 24/7 support."
  }'

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V6U",
    "name": "Product Information",
    "description": "Product specifications and features",
    "status": "PROCESSING",
    "type": "TEXT",
    "created_at": "2025-01-15T11:00:00Z",
    "updated_at": "2025-01-15T11:00:00Z"
  },
  "errors": null
}