Delivery URLs

Every asset has a stable delivery URL and a readable public path. Use either in websites, apps, emails, docs, or anywhere else the asset should appear.

Canonical delivery URL:

https://stashr.dev/acme/launch-site/brand/hero.optimized.webp

Workspace slugs keep asset paths safe when different customers use the same project slug. Delivery URLs do not require an API key. Anyone with the URL can fetch the asset, so only share links you are comfortable publishing.

Use the exact deliveryUrl returned by the management API. Stored image filenames can change extension or include a variant suffix after upload optimization.

Delivery Allowance

Each plan includes monthly delivery. Extra delivery is prepaid with bundles from Billing. Purchased delivery carries over month to month and is only used after the current month's included delivery runs out.

If the included delivery and prepaid delivery are both exhausted, public delivery pauses until more delivery is added or the next monthly allowance begins.

Image Transforms

Images can be resized and converted with public URL parameters. This is separate from the authenticated management API and from upload optimization.

See Image transforms for the supported short parameters, exact limits, responsive examples, and delivery behavior.

PDFs And Other Files

PDFs and other non-image files are served as uploaded:

<a href="https://stashr.dev/acme/launch-site/docs/brand-guidelines.pdf" target="_blank" rel="noreferrer">
  Download brand guidelines
</a>

Image transform parameters only apply to images. Other files are served as uploaded.