API reference

Base URL: https://api.spawnbase.gg/api/v1 · Auth: Authentication · Errors: Errors

This page renders the OpenAPI spec generated from the API code (Hono zod-openapi). If an operation is missing here, it is missing from the spec — file it against the API package, do not document it by hand.

Method	Path	Summary
GET	/api/v1/file	List files
POST	/api/v1/file	Upload a file (multipart)
POST	/api/v1/file/base64	Upload a file (base64 JSON)
GET	/api/v1/file/presigned-url	Create a presigned upload URL (GET, Fivemanage shape)
POST	/api/v1/file/presigned-url	Create a presigned upload URL (POST, bindable)
POST	/api/v1/file/presigned-url/{token}	Upload to a presigned URL (multipart POST or raw PUT)
GET	/api/v1/file/usage	Current-period usage vs plan limits
GET	/api/v1/file/{path}	File metadata by id or path
DELETE	/api/v1/file/{path}	Delete a file
PATCH	/api/v1/file/{id}	Publish or unpublish a file (files:publish)
POST	/api/v1/file/{id}/share	Create a bearer read link (files:publish)
DELETE	/api/v1/file/{id}/share	Revoke all shares for a file (files:publish)
GET	/api/v1/file/{id}/content	Read file bytes with files:read or a valid bearer share
GET	/api/v1/logs/aggregate	Aggregate retained logs into bounded chronological buckets
GET	/api/v1/dashboards	List saved dashboards
POST	/api/v1/logs/datasets	Create a log dataset
DELETE	/api/v1/logs/datasets/{name}	Delete a dataset and its logs
GET	/api/v1/support/team/view	Team support grants, signed history and dashboard notifications
POST	/api/v1/support/team/grants	Approve exact read-only resources for a named operator
DELETE	/api/v1/support/team/grants/{id}	Revoke support consent immediately; audit retries on outage
GET	/api/v1/support/staff/grants	List grants for the live immutable staff identity
GET	/api/v1/support/staff/grants/{id}/{kind}/{resource}	Audited exact resource read; at most 1 MiB per request

Raw spec: /openapi.json · version 1.0.0