Add repeating text watermarks.
Draws a text watermark using built-in presets (`confidential-diagonal`, `top-secret-stencil`, `eyes-only-centered`, `draft-outline`, `void-repeat`) or custom parameters. Drop this helper wherever you want to add repeating text watermarks with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.
/documents/add-watermarkWhere this helper shines
Add repeating text watermarks. keeps documents helpers on autopilot. Use it whenever you need to add repeating text watermarks without pausing a sprint or asking design/dev to jump in.
- Trigger this helper whenever you need to add repeating text watermarks without waiting on a full deploy.
- Drop it into automations (Zapier, Make, workers) to add repeating text watermarks as part of your workflow.
- Share the GET URL so support and success can add repeating text watermarks safely using their Dataczar API key.
Copy & ship snippets
GET
Instant link
GET https://api.dataczar.app/documents/add-watermark?url=https%3A%2F%2Fexample.com%2Fsample.png&text=Launch+promo&preset_id=sample-preset_id&angle=40&ak=demoOpen directly in any browser, webhook, or low-code workflow.
curl
curl GET
curl "https://api.dataczar.app/documents/add-watermark?url=https%3A%2F%2Fexample.com%2Fsample.png&text=Launch+promo&preset_id=sample-preset_id&angle=40&ak=demo"Swap ak=demo with your Dataczar API key.
curl
curl POST
curl -X POST "https://api.dataczar.app/documents/add-watermark?ak=demo" \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com/sample.png",
"text": "Launch promo",
"preset_id": "sample_preset_id",
"angle": 40,
"color": "#38bdf8",
"size": 60,
"spacing": 70,
"pages": "sample_pages",
"dryrun": true
}'Send JSON payloads from back-end jobs, queues, or workers.
Parameters
Query Parameters
| Name | Type | Description |
|---|---|---|
| url | string | |
| text | string | Override the preset text. |
| preset_id | string | |
| angle | number | |
| color | string | |
| size | number | |
| spacing | number | |
| pages | string | |
| dryrun | boolean |
All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.
Responses
Status 200
PDF with the watermark applied.
Examples
Request
"POST /documents/add-watermark {\"url\":\"https://example.com/brief.pdf\",\"preset_id\":\"confidential-diagonal\",\"dryrun\":true}"Response
{
"ok": true,
"data": {
"summary": [
"Watermark preset confidential-diagonal",
"Applied to all pages"
]
},
"meta": {
"dryrun": true
}
}Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.