Skip to main content
POST
/
api
/
v1
/
collections
cURL
curl -X POST https://app.okrapdf.com/api/v1/collections \
  -H "Authorization: Bearer okra_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q4 Earnings", "doc_ids": ["ocr-abc123"]}'
{
  "id": "col-abc123def456",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "metadata": {}
}
Idempotent document adds. If you include doc_ids that are already in the collection, they are silently skipped.

Authorizations

​
Authorization
string
header
required

API key as Bearer token: Authorization: Bearer okra_xxx

Body

application/json
​
name
string
required

Collection name (unique per user)

Example:

"Q4 Earnings"

​
description
string

Optional description

​
doc_ids
string[]

OCR job IDs to add on creation

Response

Collection created

​
id
string
required
Example:

"col-abc123def456"

​
name
string
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
description
string | null
​
metadata
object