Shotstash
API referenceREST referenceMedia

Cover or avatar image

A project cover or user avatar as JPEG; for any signed-in account that may view projects.

Try the REST routes against the public demo at https://demostash.aldyernesto.my.id. Get a read-only token (valid for 60 minutes), then paste it as the Bearer token in the console of any route.

GET/media/c/{kind}/{id}No try-it console: the demo answers cross-origin requests on /api only.

A project cover or user avatar as JPEG; for any signed-in account that may view projects.

Authorization

SessionCookie
cookieshotstash_session<token>

The same session as an HttpOnly cookie scoped to /media (set by login and POST /api/v1/auth/cookie). Only /media routes read it.

Path Parameters

kind*string

project or user.

Value in"project""user"
id*string

Cover id (UUID).

Query Parameters

v?string

Cache-busting version from the cover URL.

Response Body

The image

response?stringimage/jpeg

A JPEG image.

curl -X GET "https://example.com/media/c/project/string"
"string"

Register a worker POST

Exchanges the shared bootstrap token for a per-worker token (shown once). The manifest names the worker and its version and the kinds it processes and the contract major (1).

Download a file GET

The original bytes as an attachment; Range is supported for parallel and resumed downloads.