> ## 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.

# Upload PDF (Multipart)

> Upload a PDF file using multipart form data.

## Overview

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

## Request

<ParamField query="page_images" type="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`.
</ParamField>

<ParamField query="strategy" type="string">
  Processing strategy hint.
</ParamField>

<ParamField body="file" type="file" required>
  The PDF file to upload.
</ParamField>

<ParamField body="capabilities" type="string">
  Comma-separated capability flags.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.okrapdf.com/v1/documents \
    -H "Authorization: Bearer okra_YOUR_KEY" \
    -F "file=@report.pdf" \
    -F "capabilities=vlm_qwen"
  ```
</RequestExample>

### Response (202)

```json theme={null}
{
  "id": "doc-abc123",
  "status": "queued"
}
```