Create Hosted PDF

curl -X POST https://api.okrapdf.com/v1/host \
  -H "Authorization: Bearer $OKRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "file_id": "file_abc123" },
    "namespace": "acme-report",
    "title": "Acme Report"
  }'

POST

host

curl -X POST https://api.okrapdf.com/v1/host \
  -H "Authorization: Bearer $OKRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "file_id": "file_abc123" },
    "namespace": "acme-report",
    "title": "Acme Report"
  }'

Overview

Publish an existing PDF from /v1/files or /v1/documents as https://{namespace}.okrapdf.dev. Internal storage keys such as original.pdf are not exposed.

source

object

required

Source file or document reference. Use a file ID for passive assets or a document ID for parsed documents.

namespace

string

Desired DNS-label namespace. If omitted, okraPDF generates one.

title

string

Human-readable title for the hosted PDF.

access

object

Optional access settings such as disabled, unlisted, expiry, password, download availability, and indexing.

curl -X POST https://api.okrapdf.com/v1/host \
  -H "Authorization: Bearer $OKRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "file_id": "file_abc123" },
    "namespace": "acme-report",
    "title": "Acme Report"
  }'

Response

{
  "namespace": "acme-report",
  "deployment": {
    "url": "https://acme-report.okrapdf.dev"
  }
}

List Hosted PDFs Get Hosted PDF

Overview

Files

Documents

Content

Entities

AI

Exports

Hosting

Conversions

Agents

Workflows

Collections

Filings (Data API)

Companies (Data API)

SDK & React

Create Hosted PDF

Overview

Response

​Overview

​Response

Overview

Response