Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stashy.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL

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

​
Authentication

All /v1/* endpoints require a Bearer token: 
Authorization: Bearer <your-api-key>
Generate API keys from the web dashboard after signing in with Google OAuth.

​
Endpoints

MethodPathAuthDescription
POST/v1/filesBearerUpload a file
GET/v1/files/{id}BearerDownload a file
PUT/v1/files/{id}BearerReplace a file (owner only)
DELETE/v1/files/{id}BearerDelete a file (owner only)
POST/v1/files/{id}/publishBearerMake a file public
POST/v1/files/{id}/unpublishBearerRemove public access

​
OpenAPI Spec

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