Skip to main content

​
Visibility

Files uploaded to Stashy are private by default. Access depends on visibility: Use the Publish and Unpublish API endpoints to control visibility. Every file gets a permanent URL based on its ID:
The URL is returned in the url field when you upload a file. The response includes the original Content-Type header, so browsers render images, PDFs, etc. natively.

​
Slugs

You can attach a human-readable slug to any file. The slug becomes the last segment of the canonical URL:
The ID-only URL (/{id}) continues to work after a slug is set — both forms resolve to the same file. Use the Update endpoint to set or clear a slug:
The response returns the updated canonical URL. Slugs are limited to 128 characters and may only contain A–Z a–z 0–9 . _ ~ -. To clear a slug, send an empty string:

​
CDN Usage

Published files are ideal for CDN or subdomain mapping:
Point your CDN or reverse proxy at Stashy’s /{id} or /{id}/{slug} path. No auth headers needed for published files — ideal for edge caching.