Stirling PDF icon

Stirling PDF

Merged API: Stirling PDF - Processing API + Stirling PDF - Management API + Stirling PDF - System API

Actions260

General → Overlay Pdfs

AI-generated

Summary

Overlay one or more PDF files onto a base PDF either from binary input or server-side stored file, applying overlays according to a specified mode and position (foreground or background).

Inputs

  • Input Binary Field Name (File Input) — Name of the binary property containing the base PDF file data; used if File ID is not provided.
  • File Id — ID of a previously stored base PDF file on the server; used instead of binary input for asynchronous processing.
  • Overlay Files (required) — Array of PDF files to overlay on the base PDF; order and repeat behavior depend on the overlay mode.
  • Overlay Mode (required) — Determines how overlay files are applied: SequentialOverlay (one after another), InterleavedOverlay (round-robin per page), or FixedRepeatOverlay (fixed repeats per overlay using the counts array).
  • Counts — Array of integers specifying repeat counts per overlay file, required only for FixedRepeatOverlay mode; length must match overlay files array.
  • Overlay Position (required) — 0 for overlay in foreground, 1 for overlay as background.

Output shape

a binary PDF file with overlays applied

The output is a single binary file representing the base PDF with the specified overlay PDFs applied according to the chosen mode and position. The operation supports batch processing controlled by request options but always returns the combined PDF for each input item.

Links

Discussion