Important Notes

Important Notes

• Public by default — All images in public containers are accessible to anyone with the URL. Do not upload sensitive or private content to public containers. Treat every image URL as shareable.
• This is a rendering service — The Assets API only serves and transforms images. Uploads are handled through the Management API.
• No query params = original image — Requesting a URL without transformation parameters returns the original file at full resolution.
• URL is the identity — The file path is permanent and tied to all cache layers. To replace an image, re-upload it with a new path. There is no way to overwrite an image at the same path and have caches update.
• Transforms are billed — Each unique combination of URL + parameters that is not already cached on disk counts as a new transform. Keep your parameter combinations consistent to maximize cache hits and minimize cost.