Stamp a text watermark onto a draft PDF

Draws a Helvetica-bold text stamp on selected pages (default: all). Positions: diagonal (default), center, or footer. Deterministic pdf-lib — no Seal-hosted model inference.

POST/documents/pdf/watermark

Authorization

AuthorizationBearer token · headerrequired

Pass your API key as a Bearer token. API keys are scoped to specific operations — configure scopes in your organization's Settings → Developer → API Keys.

Request body

requiredapplication/json

idstringrequired

textstringrequired

max length 120

opacitynumber

min 0.05 · max 1

positionstring

Allowed:diagonalcenterfooter

colorstring

Hex color, e.g. #888888

sizenumber

min 6 · max 120

pagesinteger[]

Responses

200

Watermarked

successboolean

storage_idstring

page_countinteger

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST "https://api.seal.nyc/api/v1/documents/pdf/watermark" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "string",
  "text": "string",
  "opacity": 0.05,
  "position": "diagonal",
  "color": "string",
  "size": 6,
  "pages": [
    1
  ]
}'

const response = await fetch("https://api.seal.nyc/api/v1/documents/pdf/watermark", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"id\": \"string\",\n  \"text\": \"string\",\n  \"opacity\": 0.05,\n  \"position\": \"diagonal\",\n  \"color\": \"string\",\n  \"size\": 6,\n  \"pages\": [\n    1\n  ]\n}"
});

import requests

response = requests.post(
    "https://api.seal.nyc/api/v1/documents/pdf/watermark",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"id\": \"string\",\n  \"text\": \"string\",\n  \"opacity\": 0.05,\n  \"position\": \"diagonal\",\n  \"color\": \"string\",\n  \"size\": 6,\n  \"pages\": [\n    1\n  ]\n}",
)

Response

{
  "success": true,
  "storage_id": "string",
  "page_count": 0
}