Skip to main content

Batch Generation

POST https://api.getdeckle.dev/v1/generate/batch Submit up to 100 PDF generation jobs at once. Jobs are processed asynchronously via a background queue. Returns 202 Accepted with a batch ID and individual generation IDs that you can poll for status.

Request Headers

Request Body

Item Object

Each item accepts the same parameters as a single /v1/generate call: * Each item must include at least one of html, react, or template.

Options Object

Example

Response — 202 Accepted

Use the individual generation IDs with GET /v1/generations/:id to check the status of each job.

Idempotency

Pass an Idempotency-Key header with a unique string to safely retry failed requests. If a batch with the same key was already submitted within 24 hours, the original response is returned without creating duplicate jobs.

Errors