Skip to main content
POST
/
v1
/
documents
curl -X POST https://api.okrapdf.com/v1/documents \
  -H "Authorization: Bearer okra_YOUR_KEY" \
  -F "file=@report.pdf" \
  -F "capabilities=vlm_qwen"

​
Overview

Upload a PDF file directly using multipart/form-data. The document is assigned an ID and queued for processing.

​
Request

​
page_images
string
Page image rendering strategy: none, cover (default), or lazy.
​
strategy
string
Processing strategy hint.
​
file
file
required
The PDF file to upload.
​
capabilities
string
Comma-separated capability flags.
curl -X POST https://api.okrapdf.com/v1/documents \
  -H "Authorization: Bearer okra_YOUR_KEY" \
  -F "file=@report.pdf" \
  -F "capabilities=vlm_qwen"

​
Response (202)

{
  "id": "doc-abc123",
  "status": "queued"
}