Greypony API

Programmatic watermarking, vault access, and image analytics. Authenticate with gpr_live_* keys from your dashboard.

Authentication

Send your API key in the Authorization: Bearer gpr_live_… header or as x-api-key. Create keys in Dashboard → API keys. Rotate after copying — the full secret is shown once.

POST/api/v1/watermark

Upload an image and receive a watermarked asset with share link and attestation.

Parameters

file — required — JPEG, PNG, or WebP (multipart)
title — optional — display name for the asset
watermarkText — optional — overlay text (all tiers)
position — optional — bottom-right | bottom-left | center | tiled (Business)
opacity — optional — 0.1 to 1.0

Example

curl -X POST https://greypony.company/api/v1/watermark \
  -H "Authorization: Bearer gpr_live_..." \
  -F file=@photo.jpg \
  -F watermarkText="© Your Brand"

GET/api/v1/vault

List vault assets for your workspace with view, download, and copy counts.

GET/api/v1/vault/:id/distributions

List distribution records for where an asset was shared.

POST/api/v1/vault/:id/distributions

Log an external post with consent confirmation and visibility.

Parameters

platform — required — instagram | x | palomino | other | …
destinationUrl — required — post URL
visibility — required — public | private | unlisted | restricted
consentConfirmed — required — must be true
metadata — optional — json object

Example

curl -X POST https://greypony.company/api/v1/vault/ASSET_ID/distributions \
  -H "Authorization: Bearer gpr_live_..." \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","destinationUrl":"https://instagram.com/p/…","visibility":"public","consentConfirmed":true}'

GET/api/v1/analytics

Workspace image analytics: daily views, top assets, totals, and external distribution counts. Retention follows your plan tier.

How tracking works →

GET/api/v1/usage

Current-month watermark and API call quotas versus plan limits.

Plans & limits

Plan	Watermarks/mo	API calls/mo	Analytics
Basic	10	100	30 days
Core	1000	10000	90 days
Sovereign API	10000	100000	365 days

Errors

401 — missing or invalid API key
403 — plan limit exceeded or feature not available on tier
413 — file exceeds plan upload size
429 — rate limit (retry with backoff)

Authentication

Consent & distributions

Plans & limits

Errors