Merge PDFs
POST/pdf/merge
Joins PDFs, in the order given, into a new PDF. A source is a succeeded PDF render of the
workspace whose output still exists (rnd_…), or a PDF of the workspace's file library by
name (terms.pdf) or file id (fil_…); render sources must all be stored in one region. The
result is a render of its own (it appears in the render log and GET /renders/{id}), is
held to the plan's page and size limits, and costs 0.5 units on live keys. Part of the Starter plan and above (403
forbidden, feature: post_processing, below). A source that does not exist answers 422
source_not_found, one that is no PDF or has not succeeded 422 source_invalid. Needs
render:create.
Request
Responses
- 200
- 429
- default
Merged render.
rate_limited: the workspace's bucket of the plan's requests per second is empty (Free test keys also have 30 a minute). The problem names the bucket's limit and its window_seconds. Retry after Retry-After seconds.
Response Headers
Seconds until a request is let through again.
Size of the workspace's request bucket: the plan's requests per second. Free test keys are also held to 30 requests a minute, and the headers then describe whichever bucket is closer to empty.
Requests left in the bucket.
Seconds until the bucket is full again.
Error (RFC 9457 problem details).