Create a PDF

Render one PDF from raw HTML, an inline stateless template, or one owned saved-template version. An omitted saved version resolves to one exact immutable version before data validation, admission, idempotency, queueing, or billing. Template evaluation happens before storage and only evaluated HTML enters render input. Returns 200 for a terminal job or 202 while the accepted job remains queued or running. A terminal job can be succeeded, failed, or cancelled; check status before downloading, then use file downloads to read the finished file. Send wait=false to skip the bounded wait. Every mode uses the same queue, renderer, retention rules, webhook, and fixed one-credit success price.

post/v1/pdf

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/pdf
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

1 to 255 printable ASCII characters. A repeated key with the same logical request replays one job; a different logical request conflicts. Stateless fingerprints include original source, sorted data, and effective render options. Saved-template fingerprints include the exact resolved template version, sorted data, and effective options. wait, request IDs, and transport choices do not affect the fingerprint.

Request body

PdfRequest required(unresolved $ref)

Response

The job is terminal. Check status for succeeded, failed, or cancelled; HTTP 200 does not mean the render succeeded.

referencestring

Your reference, preserved in the job, history, and webhook. Omitted when not supplied.

idstring required

The job's public identifier: "pdf_" followed by 32 lowercase hexadecimal characters.

status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
created_atstring date-time required
finished_atstring date-time nullable required
credit'reserved' | 'settled' | 'released' | 'free' | 'none' required

What happened to the credit this job holds: "reserved" while it is queued or running, "settled" once it succeeded, "released" once it failed or was cancelled, "free" when it is the account's free first file and costs no credit, and "none" when the job was never billed.

Changes

No recorded changes to this operation across all 1 revision of this API.