Skip to main content
POST
Upload a knowledge base

Authorizations

Authorization
string
header
required

A long-lived, privileged API key (ek_... prefix), minted once from the dashboard. Intended for trusted server-side use only; never expose it in client-side code. Send as Authorization: Bearer ek_.... Required by every Calls, Batches, Agents, Tools, MCP Servers, Documents, and Realtime route.

Body

multipart/form-data
file
file
required

Response

Successful Response

doc_id
string
required
file_name
string
required
status
enum<string>
required
Available options:
ready,
processing,
error
size_bytes
integer
default:0
created_at
string | null