Saving to your storage

By default Urlbox hosts the render for 30 days. To keep renders longer or in your own infrastructure, save them to your bucket — or have Urlbox notify you when a render is ready.

Save to your bucket

Configure storage on your project first, then enable it per request:

• use_s3 — upload the render to your configured bucket (HiFi plan).
• s3_path — the path and filename to use in the bucket.
• cdn_host — serve the result from your own CDN domain.

{  "url": "https://example.com",  "use_s3": true,  "s3_path": "screenshots/example.png"}

See the storage setup guides for S3, R2, GCS, DigitalOcean Spaces, and Backblaze B2.

Get a webhook instead of polling

For the asynchronous API, webhook_url tells Urlbox to POST the result to you when the render finishes — no polling required (set on ~39% of renders).

{  "url": "https://example.com",  "webhook_url": "https://your-app.com/urlbox-webhook"}

Verify the request came from Urlbox using your project's webhook secret — see Webhooks.

Presigned URLs

s3_presigned_url returns a time-limited link to the render in your bucket without exposing your storage credentials.