External Storage

Skymage can fetch private objects from configured storage credentials and apply the same transformations used for public-origin images.

Supported Drivers

• Amazon S3 and S3-compatible storage
• Bunny Storage

URL Pattern

https://{handle}.skymage.net/v1/ex/{storage-handle}/{object-path}?{parameters}

Example:

https://demo.skymage.net/v1/ex/product-images/catalog/item-001.jpg?w=600&h=600&fit=contain&f=webp&q=84

The storage configuration is resolved for the user who owns the pull zone. Only configurations with a connected status are used by the processing service.

Setup

1. Open External Storage in the Skymage dashboard.
2. Select Amazon S3 or Bunny Storage.
3. Enter a unique storage handle and provider credentials.
4. Test the connection.
5. Use the storage handle in /v1/ex/ URLs.

Cache Behavior

Transformed storage objects use immutable CDN caching. Purge the pull-zone cache or change the URL when replacing an object at the same path.

Errors

Status	Meaning
404	Pull zone, storage handle, or object was not found.
503	The storage provider could not be reached or rejected the credentials.
500	The object was fetched but image processing failed.