Create Knowledge Base From Files

curl --request POST \
  --url https://api.example.com/v1/knowledge-base/files \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form files.items='@example-file'

{
  "success": [
    {
      "id": "<string>",
      "name": "<string>",
      "size_bytes": 123,
      "type": "file"
    }
  ],
  "failed": [
    {}
  ]
}

Knowledge Base

Create Knowledge Base From Files

Upload multiple files (up to 10) to knowledge base.

Supported file types: PDF, DOCX, DOC, PPTX, PPT, TXT, CSV, XLSX, XLS, RTF, MD, HTML, XML Max file size: 21MB per file

Request:

files: List of files to upload (multipart/form-data)

Returns:

success: List of successfully processed files with document IDs
failed: List of files that failed to process with error messages

Each file is processed independently. If some files fail, successful ones are still stored in the knowledge base.

Example:

curl -X POST "http://localhost:8000/v1/knowledge-base/files" \
  -H "Authorization: Bearer <token>" \
  -F "[email protected]" \
  -F "[email protected]"

POST

knowledge-base

files

Create Knowledge Base From Files

curl --request POST \
  --url https://api.example.com/v1/knowledge-base/files \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form files.items='@example-file'

{
  "success": [
    {
      "id": "<string>",
      "name": "<string>",
      "size_bytes": 123,
      "type": "file"
    }
  ],
  "failed": [
    {}
  ]
}

Headers

x-api-key

string | null

API key for authentication

Body

multipart/form-data

files

file[]

required

Response

Successful Response

Response after uploading multiple files

success

KnowledgeBaseFileCreateResponse · object[]

required

Show child attributes

success.id

string

required

success.name

string

required

success.size_bytes

integer

required

success.type

string

default:file

failed

Failed · object[]

required

Create Knowledge Base From Text Endpoint

List Document Rag Indexes

⌘I

Getting Started

Agents

Batch Calling

Voices

Conversations

Payments

Knowledge Base

Webhooks

Workers

Create Knowledge Base From Files

Headers

Body

Response