Reliability and operations

Predictable document generation when workloads grow

Understand how PDFDesignAPI handles synchronous requests, durable jobs, retries, private results, readiness, and bounded failure before integrating a production workflow.

How it helps

Operational behavior you can design around

These controls describe current product behavior. Availability commitments and support terms depend on the commercial agreement for your deployment.

Synchronous generation

Generate one PDF directly when the request fits configured payload, concurrency, rate, and execution limits.

Durable asynchronous jobs

Queue larger work in PostgreSQL-backed jobs that survive application restarts and expose explicit status.

Atomic worker claims

Workers claim the oldest available job atomically so parallel workers do not process the same job.

Bounded retries

Transient failures are retried with delayed availability; terminal failures retain a sanitized error state without retaining request payload values.

Private expiring results

Async and idempotent results require authorization and expire after 24 hours under the current retention policy.

Component readiness

The health endpoint reports database and Chrome readiness separately and returns a degraded status when dependencies are unavailable.

Version-pinned rendering

Immutable versions and development, staging, and production aliases keep a tested document contract stable during releases.

Fail-closed media policy

Renderer networking rejects private, loopback, metadata, reserved, credentialed, unsupported, and unresolvable media destinations.

Frequently asked questions

Do async jobs survive an API restart?
Yes. Jobs and their state are stored durably in PostgreSQL rather than in application memory.
How long are generated job results retained?
The current result-retention period is 24 hours. Download and persist documents in your own authorized workflow when longer retention is required.
Does this page promise an SLA?
No. It documents technical behavior, not a contractual availability commitment. Contact the team for current support and deployment terms.

Start with a real document

Create a template and generate your first PDFs without a credit card.

Review the API quickstart