Skip to main content
POST
/
api
/
v1
/
collections
/
{collectionId}
/
documents
cURL
curl -X POST https://app.okrapdf.com/api/v1/collections/col-abc123/documents \
  -H "Authorization: Bearer okra_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"doc_ids": ["ocr-ghi789"]}'
{
  "added": 123,
  "total_requested": 123
}
Idempotent. Documents already in the collection are silently skipped.

Authorizations

Authorization
string
header
required

API key as Bearer token: Authorization: Bearer okra_xxx

Path Parameters

collectionId
string
required

Body

application/json
doc_ids
string[]
required

OCR job IDs to add

Example:
["ocr-abc123", "ocr-def456"]

Response

Documents added

added
integer

Number of documents actually added

total_requested
integer

Number of documents requested