Async jobs

Some operations — OCR on a 500-page scan, compression with max re-encoding, batch workflows — take longer than a synchronous HTTP response window. For these, SnapPDF offers an async queue with webhook completion events.

When to use async

• OCR on PDFs with 100+ pages at high DPI.
• Compression at level=max on 50+ MB files.
• Any pipeline you want to retry independently of the HTTP request.

Flow

1. 1. Set X-SnapPDF-Async: true on your request.
2. 2. Response is 202 Accepted with a job_id.
3. 3. Poll GET /api/v1/jobs/{id} OR subscribe to the operation.completed webhook.
4. 4. Download the output via the pre-signed URL returned in the event.

Retention

Job artifacts live in S3 for 24 hours, then purge. Copy to your own storage before expiry.