Skip to main content
POST
Add watermark

Phase

Phase 2

Request

object
required
The PDF to watermark. One of:
  • { "pdf_id": "pdf_abc123" }
  • { "url": "https://example.com/doc.pdf" }
  • { "base64": "JVBERi0x..." }
object
Text watermark config. Mutually exclusive with image.
  • content (string, required) — The watermark text, e.g., “CONFIDENTIAL”, “DRAFT”.
  • font_size (integer, default: 48) — Font size in points.
  • color (string, default: “#00000020”) — Color with alpha, hex format.
  • rotation (number, default: -45) — Rotation in degrees.
  • position (string, default: “center”) — One of: center, top-left, top-right, bottom-left, bottom-right.
object
Image watermark config. Mutually exclusive with text.
  • url (string) — URL to the watermark image (PNG, JPEG, SVG).
  • base64 (string) — Base64-encoded image. Use this or url, not both.
  • width (string, default: “200px”) — Image width.
  • opacity (number, default: 0.1) — Range: 0.0 to 1.0.
  • position (string, default: “center”) — Same options as text watermark.
string
default:"all"
Which pages to watermark. "all", "1-3", "1,3,5", or "odd"/"even".
string
default:"over"
over — watermark renders on top of content. under — watermark renders behind content.
string
default:"url"
url or base64.

Response

Example