Skip to main content
POST
Upload knowledge document
Requires scope knowledge:write.
  • Multipart field name: file
  • Types: PDF, DOC/DOCX, XLS/XLSX/XLSM, TXT
  • Max size: 50MB
Live keys: credits may be debited when KB billing is enabled (402 insufficient_credits if balance too low). Sandbox keys: upload succeeds without debiting credits; response includes billing.sandbox: true. There is no v1 download endpoint — binary access stays dashboard/session only.

Authorizations

Authorization
string
header
required

Paste only your API key (ond_live_… or ond_test_…). Do not type the word Bearer — the playground adds it.

Body

multipart/form-data
file
file
required

Response

Uploaded

document
object

Metadata only. No download URL or file bytes.

billing
object