Skip to content

Signed image links

Creative images are served through signed links. A link names one image of one organization and carries its own proof, so it works in an <img> tag or a download without an API key. Treat a link like a short-lived secret: anyone who has it can open the image until it expires.

imageUrl in creatives, Playground images and incidents looks like:

https://api.ad80.dev/v1/images/<org>/<contentHash>?exp=<unix seconds>&sig=<hex>
  • It expires 10 minutes after the response was made; imageUrlExpiresAt says when.
  • After that it answers 403 (image link expired). Request the creative again for a fresh link.
  • The image is a PNG (Content-Type: image/png). The response allows cross-origin use, so you can show it on your own pages.
  • A link whose signature was changed answers 403; a link for an image your organization does not have answers 404.

E-mails and webhooks carry a longer-lived link of the form:

https://api.ad80.dev/v1/creatives/<contentHash>/image?exp=<unix seconds>&org=<org>&sig=<hex>

It stays valid for 7 days. An expired link answers 410. A webhook subscription with attach_image also carries the image itself, base64-encoded, in the payload (see Webhook events).

If you need images for longer (for an archive or an evidence file), download them while the link is valid and store them yourself.