Overview - Stashy.sh

Base URL

http://localhost:8080

In production, set HOSTNAME to your public URL (e.g., https://stashy.example.com).

All /api/v1/* endpoints require a Bearer token:

Authorization: Bearer <your-api-key>

Generate API keys from the web dashboard after signing in with Google OAuth.

Method	Path	Auth	Description
`POST`	`/api/v1/files`	Bearer	Upload a file
`GET`	`/api/v1/files/{id}`	Bearer	Download a file
`GET`	`/{id}`	None	Direct public file access

The full OpenAPI 3.1 spec is available at /openapi.yaml on your running instance.