Changelog

Release history for the Airpdf Render API and official SDKs.

We use Semantic Versioning per artifact. The HTTP API and each SDK version independently.

API · v1.0.0 — 2026-05 (preview)

First public release.

Endpoints

POST /api/v1/render — sync (binary or URL) and async (with webhook) render
GET /api/v1/render/:id — poll render status
GET /api/v1/templates — list active templates in workspace
GET /api/v1/templates/:slug — get a single template + variables schema

Auth

Bearer tokens with airpdf_live_* (production) and airpdf_test_* (sandbox) prefixes
Per-key rate limit tied to workspace plan

Webhooks

HMAC-SHA256 signed deliveries on render.succeeded / render.failed
Replay protection via X-Airpdf-Timestamp (5 min tolerance)
No retries yet — single-attempt delivery (retries planned for v1.1)

Storage

Service-managed: Wasabi eu-central-1 with 1h presigned URLs
Customer-owned: S3 / R2 / MinIO / Wasabi / S3-compatible
Credentials encrypted at rest (AES-GCM via Cloak)

SDKs · v0.1.0 — 2026-05 (preview)

Initial release for all 12 SDKs simultaneously.

Tier 1 (officially maintained)

@airpdf/sdk (npm, Node 18+)
airpdf-sdk (PyPI, Python 3.9+)
github.com/zoonect/airpdf-sdk-go (Go 1.22+)
airpdf-sdk (RubyGems, Ruby 3.0+)

Tier 2 (community / preview)

airpdf/sdk (Composer, PHP 8.1+)
Airpdf.Sdk (NuGet, .NET 8 / netstd 2.1)
it.airpdf:airpdf-sdk (Maven Central, Java 17+)
airpdf_sdk (Hex, Elixir 1.15+)

Tier 3 (experimental, not yet published)

Rust, Kotlin, Swift, Dart — reference implementations in the monorepo

Common surface

All SDKs ship: render, renderAsync, getRender, waitForRender, verifyWebhook, plus uniform error classes.

Editor · 2026-04

REPL-style JSX editor (CodeMirror 6 + one-dark theme)
Client-side JSX → JSON tree compilation (acorn + acorn-jsx)
Whitelisted primitives: Document, Page, View, Text, Image, List
Live PDF preview via @react-pdf/renderer browser build
Variables manager (JSON Schema) in collapsible drawer

Platform · 2026-04

12 starter templates (Invoice, Report, Letter, Badge, Receipt, …)
Multi-tenant with per-workspace Postgres schemas
Stripe billing with 6 tiers (Free → Enterprise)
Honeybadger error reporting
Mailgun transactional email
Status page at airpdf.app/status

Roadmap (not committed)

Things we're considering — order and timing subject to change.

HTML→PDF endpoint (POST /api/v1/render-html) for DocRaptor migration paths
Webhook retries with exponential backoff
Idempotency-Key header support
Templates v2: server-side variable defaults, computed fields, locale-aware formatting
Multi-region render pool (US + EU)
SSO (SAML, OIDC) for Enterprise
Audit log for security-conscious workspaces
Tier 3 SDKs to Tier 2 as we publish to registries

Email hello@airpdf.app if you'd like to influence priority — what would unblock you?