SIsimplified
convert

Media · Image · Combine images into a single PDF

Combine multiple images — mixed formats supported (PNG, JPEG, WEBP, HEIC/HEIF) — into a single PDF, one page per image, in the given order. Each entry in images is a remote URL or an existing Simplified asset UUID (resolved server-side, scoped to the caller's workspace). This produces a NEW combined PDF from separate source images — for converting a single image's own container format use convertImageFormat instead. Async — returns a task_id (auto-polled).

post/api/v1/tools/images-to-pdf

Request

  • Base URL
    https://api.simplified.com
  • Auth
    API key in header Authorization

Request body

imagesstring[] required

Ordered list of image sources — each a remote URL or an existing Simplified asset UUID. Page order matches this order.

namestring

Output PDF filename. Defaults to "images.pdf".

page_layout'fit-to-image' | 'a4' | 'letter'

"fit-to-image": each page sized to its own source image. "a4" / "letter": fixed page size, image centered and scaled to fit within margins.

on_error'fail' | 'skip'

"fail": abort if any image can't be fetched or decoded. "skip": best-effort — assemble from whatever succeeded; skipped inputs are reported in the result.

Response

Async task queued.

task_idstring

Poll GET /api/v1/tasks/{task_id} until SUCCESS or FAILURE.

Changes

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