Skip to content
Utilerio
All endpoints

Watermark PDF

POST/api/v1/pdf/watermark

Stamp a text watermark across every page of a PDF, tiled or centered, with adjustable opacity and rotation.

Authentication

Requires an API key in the X-API-Key header.

Try it

POST/api/v1/pdf/watermark

Parameters

pdfBase64stringrequired

Base64-encoded PDF file.

textstringrequired

Watermark text.

opacitynumberoptional

0–1. Default 0.2.

rotationintegeroptional

Degrees, counter-clockwise. Default 45.

colorstringoptional

Hex color, e.g. #8c8c8c. Default #8c8c8c.

tiledbooleanoptional

Repeat across the page instead of one centred stamp. Default true.

pagesstringoptional

Page range, e.g. "1-3,5". Default: every page.

Request body

{
  "pdfBase64": "JVBERi0xLjQK...",
  "text": "CONFIDENTIAL",
  "opacity": 0.2,
  "tiled": true
}

Response codes

  • 200Success.
  • 400Invalid request — check your body or parameters.
  • 401Missing or invalid API key.
  • 403The API key is not scoped to this endpoint.
  • 429Rate limit exceeded — retry after a short wait.

Language

cURL

Request

curl -X POST https://utilerio.com/api/v1/pdf/watermark \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdfBase64":"JVBERi0xLjQK...","text":"CONFIDENTIAL","opacity":0.2,"tiled":true}'

Response

binary application/pdf