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"

Documentation Index

Fetch the complete documentation index at: https://docs.okrapdf.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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: eager (default, render all pages), cover (page 1 only), or none. lazy is accepted as a deprecated alias for eager.
​
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"
}