Overview - Stashy.sh

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

Method	Path	Description
`GET`	`/v1/files`	List your files
`POST`	`/v1/files`	Create a file
`GET`	`/v1/files/{id}`	Get a file’s metadata
`GET`	`/v1/files/{id}/content`	Get a file’s content
`PUT`	`/v1/files/{id}/content`	Update a file’s content (owner only)
`PATCH`	`/v1/files/{id}`	Update slug, name, or visibility (owner only)
`DELETE`	`/v1/files/{id}`	Delete a file (owner only)

Pagination

GET /v1/files returns your files newest first, up to limit per page (default 50, max 100). To fetch the next page, pass the last file’s id as after. A page shorter than limit is the last one.

OpenAPI Spec

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