Ingest a PDF document from a URL

POST 
/api/v1/chatbots/:chatbotId/documents

Ingests a PDF into the chatbot's knowledge base by fetching it from a PUBLIC URL (SSRF-safe: http(s) only, public-IP-pinned + rebind-safe, size- and time-bounded), then running the standard extract → chunk → embed pipeline. This endpoint is PDF-only (the fileName / URL must end in .pdf); to ingest a local file, host it at a public URL first. Asynchronous — processing continues in the background; poll GET /documents for status. Required scope: documents:write.

Request

Responses

200

Document accepted; processing started in the background.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

413

File exceeds the plan upload limit or account storage limit.

415

Unsupported file type (this endpoint ingests PDF only).

429

Too Many Requests — rate limit exceeded