Upload File

POST

knowledge

learn

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "name=Company FAQs" \
  -F "description=Frequently asked questions and policies" \
  -F "file=@company_faqs.pdf"

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "description=Product documentation" \
  -F "file=@product_docs.pdf"

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
    "name": "Company FAQs",
    "description": "Frequently asked questions and policies",
    "status": "PROCESSING",
    "type": "FILE",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "file": {
      "file_name": "company_faqs.pdf",
      "file_size": 2048576,
      "file_type": "application/pdf"
    }
  },
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_LIMIT_EXCEEDED",
      "message": "You have reached your knowledge base upload limit"
    }
  ]
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_RATE_LIMITED",
      "message": "Please wait 10 seconds between knowledge base uploads, or wait for your current upload to complete."
    }
  ]
}

Upload a file to create a knowledge base item that can be used to provide contextual information to your AI agents. Supported file formats include PDF, Word documents, text files, and more.

Headers

string

required

Your API key for authentication.

string

required

Must be multipart/form-data for file uploads.

Body Parameters (multipart/form-data)

string

default:"file"

required

Must be "file" for file uploads.

string

KB name (defaults to filename if not provided).

string

Optional description of the knowledge base item content.

file

required

The file to upload and process into a knowledge base item.

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 "FILE" for file-based knowledge base items.

string

ISO timestamp of creation.

string

ISO timestamp of last update.

string

Error message if status is "FAILED".

object

File information for the uploaded file.

string

Original filename.

number

File size in bytes.

string

MIME type of the file.

null

Will be null on successful creation.

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "name=Company FAQs" \
  -F "description=Frequently asked questions and policies" \
  -F "file=@company_faqs.pdf"

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "description=Product documentation" \
  -F "file=@product_docs.pdf"

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
    "name": "Company FAQs",
    "description": "Frequently asked questions and policies",
    "status": "PROCESSING",
    "type": "FILE",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "file": {
      "file_name": "company_faqs.pdf",
      "file_size": 2048576,
      "file_type": "application/pdf"
    }
  },
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_LIMIT_EXCEEDED",
      "message": "You have reached your knowledge base upload limit"
    }
  ]
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_RATE_LIMITED",
      "message": "Please wait 10 seconds between knowledge base uploads, or wait for your current upload to complete."
    }
  ]
}

Docs for agents: llms.txt

⌘I

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "name=Company FAQs" \
  -F "description=Frequently asked questions and policies" \
  -F "file=@company_faqs.pdf"

curl -X POST https://api.bland.ai/v1/knowledge/learn \
  -H "authorization: Bearer YOUR_API_KEY" \
  -F "type=file" \
  -F "description=Product documentation" \
  -F "file=@product_docs.pdf"

{
  "data": {
    "id": "kb_01H8X9QK5R2N7P3M6Z8W4Y1V5T",
    "name": "Company FAQs",
    "description": "Frequently asked questions and policies",
    "status": "PROCESSING",
    "type": "FILE",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "file": {
      "file_name": "company_faqs.pdf",
      "file_size": 2048576,
      "file_type": "application/pdf"
    }
  },
  "errors": null
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_LIMIT_EXCEEDED",
      "message": "You have reached your knowledge base upload limit"
    }
  ]
}

{
  "data": null,
  "errors": [
    {
      "error": "KB_UPLOAD_RATE_LIMITED",
      "message": "Please wait 10 seconds between knowledge base uploads, or wait for your current upload to complete."
    }
  ]
}

Basic Tutorials

Agent Onboarding

Calls

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Headers

Body Parameters (multipart/form-data)

Response

​Headers

​Body Parameters (multipart/form-data)

​Response

Headers

Body Parameters (multipart/form-data)

Response