Dataczar
Browse helpers

API Reference / documents / add-stamp

Drop a stamp overlay (PAID, REJECTED, etc.).

Places a stamp preset on selected pages. Presets include `paid-red`, `paid-green`, `rejected`, `fail`, `approved`, `urgent`. Drop this helper wherever you want to drop a stamp overlay (PAID, REJECTED, etc.) with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.

GETPOST/documents/add-stamp

Where this helper shines

Drop a stamp overlay (PAID, REJECTED, etc.). keeps documents helpers on autopilot. Use it whenever you need to drop a stamp overlay (PAID, REJECTED, etc.) without pausing a sprint or asking design/dev to jump in.

  • Trigger this helper whenever you need to drop a stamp overlay (PAID, REJECTED, etc.) without waiting on a full deploy.
  • Drop it into automations (Zapier, Make, workers) to drop a stamp overlay (PAID, REJECTED, etc.) as part of your workflow.
  • Share the GET URL so support and success can drop a stamp overlay (PAID, REJECTED, etc.) safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/documents/add-stamp?url=https%3A%2F%2Fexample.com%2Fsample.png&stamp_id=sample-stamp_id&text=Launch+promo&position=center&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/documents/add-stamp?url=https%3A%2F%2Fexample.com%2Fsample.png&stamp_id=sample-stamp_id&text=Launch+promo&position=center&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/documents/add-stamp?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "stamp_id": "sample_stamp_id",
  "text": "Launch promo",
  "position": "sample_position",
  "rotation": 50,
  "scale": 60,
  "pages": "sample_pages",
  "dryrun": true
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

NameTypeDescription
urlstring
stamp_idstring · required
textstringOverride the preset text.
positionstring
rotationnumber
scalenumber
pagesstring
dryrunboolean

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 stamp overlay.

Examples

Request

"POST /documents/add-stamp {\"url\":\"https://example.com/invoice.pdf\",\"stamp_id\":\"paid-red\",\"pages\":\"first\",\"dryrun\":true}"

Response

{
  "ok": true,
  "data": {
    "summary": [
      "Stamp paid-red on first page",
      "Rotation 12\u00b0, scale 1.0"
    ]
  },
  "meta": {
    "dryrun": true
  }
}

File uploads (multipart form-data)

Attach PDFs or images as multipart fields. We'll fill in the field names for you.

Files
file — PDF document

Query parameters

Body parameters

We'll send these as JSON for POST/PUT/PATCH requests and as query params for GET.

Equivalent curl
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.
Get your API keyBrowse helpers
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.