Skip to navigation
Voice Agents APIKnowledge base

Upload a PDF file to a knowledge base

View as Markdown

Upload a PDF file to a knowledge base. Only PDF files are accepted (validated by MIME type and extension).

400 is returned for billing/entitlement failures before the file is processed:

  • "Insufficient credits for KB storage upload." — account lacks upload credits
  • "KB storage access is not enabled for your account." — plan doesn’t include KB storage

No application-level file size limit is enforced — any proxy or infrastructure limits (e.g. nginx) apply instead.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired
The ID of the knowledge base

Request

This endpoint expects a multipart form containing a file.
mediafileRequired

Response

Knowledge base item created successfully
statusbooleanOptional

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error