Render an HTML file into a stored PDF.
An uploaded HTML file is rendered in an isolated browser worker and stored as a PDF linked to the job. Use it for invoices, statements, and reports generated from templates.
test
quarterly-report.pdf
PDF · 18 pages · 4.2 MB
Stored before any processing starts. Job job_parse_7ab2 was returned with HTTP 202.
Result
Waiting for the worker. Poll GET /v1/file-jobs/{id} until it finishes.
- job
- job_parse_7ab2
- attempt
- —
What it does
Real product states, not a promise.
An uploaded HTML file is rendered in an isolated browser worker and stored as a PDF linked to the job. Use it for invoices, statements, and reports generated from templates.
- Isolated rendering worker per job
- Stored PDF output with its own file id
- Up to 3 attempts on worker failure
- Asynchronous: HTTP 202 then job status
Input
An uploaded HTML file_id
Output
A generated PDF file
Where it fits
Where it fits
01
Invoices and receipts
02
Statements and exports
03
Report snapshots
API example
One durable request.
POST /v1/pdf/from-html. Use an idempotency key on create calls. The full request and response contract is in Flowyn Docs.
AcceptedClaimedAttemptedTerminal statePOSThttps://api.flowyn.dev/v1/pdf/from-html202
curl -X POST https://api.flowyn.dev/v1/pdf/from-html \
-H "Authorization: Bearer flw_test_••••" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: invoice-1042" \
-d '{
"file_id": "9c1e5b7a-2d4f-4a6b-8e3c-1f0a7d2b5c64"
}'Frequently asked questions
Where is the exact request contract for HTML to PDF?
In Flowyn Docs and the OpenAPI document at https://api.flowyn.dev/openapi/v1.yaml. This page shows the request; the docs page lists every field, status value, error, and limit.
Is the operation durable?
Yes. The operation is stored before any work happens and remains a resource with state, attempts, and error context, not an ephemeral request log.
Do failures stay inspectable?
Yes. Every attempt is recorded. Repeated failures with the same fingerprint are also grouped into an Issue.
Build with HTML to PDF.
Create a workspace, make your first call in the test environment, and inspect every attempt.