Skip to main content

​
Visibility

Every file has a visibility that controls who can open it by its URL: Set it on Create with the visibility query parameter, or change it later with Update:
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

Public 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 public files — ideal for edge caching.