## ⚠️ Upcoming Changes

On **15 September 2026**, image URLs returned by the Signable public API will change.

Two changes are being introduced:

- **The URL format will change.** Integrations must not rely on the current domain, path or URL structure.
- **Image URLs will become temporary.** Each URL will remain valid for **24 hours** before a new one must be requested.


This affects the following fields:

- [Envelope document thumbnail image URLs](https://developers.signable.app/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_documents/document_thumbnails)
- [Envelope document full size image URLs](https://developers.signable.app/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_documents/document_pages)
- [Template document thumbnail image URLs](https://developers.signable.app/openapi/templates/listtemplates#templates/listtemplates/t=response&c=200&path=templates/template_thumbnails)
- [Template thumbnail image URLs](https://developers.signable.app/openapi/templates/gettemplate#templates/gettemplate/t=response&c=200&path=template_thumbnails)
- [Template document full size image URLs](https://developers.signable.app/openapi/templates/listtemplates#templates/listtemplates/t=response&c=200&path=templates/template_pages)
- [Template full size image URLs](https://developers.signable.app/openapi/templates/gettemplate#templates/gettemplate/t=response&c=200&path=template_pages)


### URL format change

The format of image URLs will change. This includes the domain, path, query parameters and other parts of the URL structure.

Please ensure your integration treats image URLs as opaque values and uses them exactly as returned by the API. Do not parse, rewrite, validate or make assumptions about their structure.

### Time-based expiry

Image URLs returned in these fields will become temporary.

Each URL will remain valid for **24 hours** from the time it is generated. After that, you'll need to make another API request to retrieve a fresh image URL.

### What this means

If your integration:

- stores image URLs indefinitely
- parses image URLs
- rewrites image URLs
- validates image URLs based on their current structure
- makes assumptions about the domain, path or other parts of the URL


you'll need to update that behaviour.

Instead:

- request a fresh image URL whenever you need one after the previous URL has expired
- treat image URLs as opaque values and use them exactly as returned by the API


### Recommended action

Review any integrations that store image URLs or depend on the current URL structure before **15 September 2026**.

### Why we're making this change

This change supports our ongoing work to strengthen platform security and improve how file access is managed over time.

### Need help?

If you think this change might affect your integration, please contact support and we'll be happy to help.