Documentation
SA Storage is a Cloudflare R2 file manager with a password-protected dashboard and a token-based REST API. Every file and token belongs to a service.
External API & tokens
Authenticate with Bearer tokens, upload and manage files, read usage statistics.
ReadServices and prefixes
How services, key prefixes, and tokens fit together — and why files never collide.
ReadPublic file URLs
Serve any object at /files/<key> with caching, ETags, and forced downloads.
Read
Endpoint map
| GET | /api/me | Current token or session |
| GET | /api/files | List objects |
| POST | /api/files | Upload (multipart) |
| GET | /api/files/<key> | Object metadata |
| PUT | /api/files/<key> | Replace contents |
| PATCH | /api/files/<key> | Move / rename, reassign service |
| DELETE | /api/files/<key> | Delete object |
| GET | /api/stats | Usage statistics and time series |
| GET | /api/services | Services (own only for tokens) |
| POST | /api/tokens/<id>/rotate | Issue a new secret (session) |
| GET | /files/<key> | Public read |
Longer references live in the repository's docs/ folder: SETUP.md, API.md, EXTERNAL-API.md, ARCHITECTURE.md.