curl -X POST https://api.okrapdf.com/v1/collections \
-H "Authorization: Bearer okra_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Q4 Earnings",
"description": "Quarterly earnings reports",
"document_ids": ["doc-abc123", "doc-def456"]
}'
Collections
Create Collection
Create a new named collection, optionally seeded with documents.
POST
/
v1
/
collections
curl -X POST https://api.okrapdf.com/v1/collections \
-H "Authorization: Bearer okra_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Q4 Earnings",
"description": "Quarterly earnings reports",
"document_ids": ["doc-abc123", "doc-def456"]
}'
Overview
Creates a new collection. You can optionally include document IDs to add at creation time.Request
string
required
Display name for the collection.
string
Optional description of the collection’s purpose.
string[]
Document IDs to seed into the collection. IDs already present are silently skipped.
curl -X POST https://api.okrapdf.com/v1/collections \
-H "Authorization: Bearer okra_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Q4 Earnings",
"description": "Quarterly earnings reports",
"document_ids": ["doc-abc123", "doc-def456"]
}'
Response (201)
{
"id": "col-40da068481cf4f248853507cba6be611",
"name": "Q4 Earnings",
"description": "Quarterly earnings reports",
"visibility": "private",
"created_at": "2025-01-15T08:30:00Z",
"document_count": 2
}