DOCS / API

REST reference

Cubster is an agent-first platform: the SDK and CLI are conveniences over one plain REST API. All responses are JSON unless serving file bytes; errors are { "error": "..." } with a matching HTTP status. Base URL: https://app.cubster.dev.

For agents

Keys are plain bearer tokens and the API is plain REST — anything that can make an HTTP request can upload. No SDK or CLI required.

$ curl -X POST https://app.cubster.dev/api/v1/uploads \

-H "Authorization: Bearer $CUBSTER_API_KEY" \

-F "file=@hero.png"

Endpoints

GET /api/v1/me	Session-or-key bootstrap: profile + workspace
PATCH /api/v1/me	Update your profile (session only)
POST /api/v1/api-keys	Create a key (session only) — returns the secret once
GET /api/v1/api-keys	List keys (prefixes only)
DELETE /api/v1/api-keys/:id	Revoke a key
GET /api/v1/workspaces	List your workspaces, with usage
POST /api/v1/workspaces	Create a workspace
PATCH /api/v1/workspaces/:id	Rename a workspace you own
DELETE /api/v1/workspaces/:id	Delete a workspace you own
POST /api/v1/uploads	Direct upload (session or key), multipart/form-data
POST /api/v1/uploads/grant	Mint a client-upload grant (key only)
POST /api/v1/uploads/client	The grant target — grant-authed upload
GET /api/v1/assets	List assets (type, search, tags, limit)
GET /api/v1/assets/:id	Asset detail
PATCH /api/v1/assets/:id	Update displayName / tags
DELETE /api/v1/assets/:id	Delete an asset
POST /api/v1/waitlist	Public — join the private-beta waitlist

Serve (public, by opaque key)

GET /img/:key — raster image via the Netlify Image CDN, transformable with a positional cascade or a named preset (/img/thumb/:key, etc.). GET /f/:key — generic file or SVG as a forced download. SVG is accepted on upload but only ever served this way, never inline.

llms.txt

The app's machine-readable API reference lives at app.cubster.dev/llms.txt. This site has its own agent surface too — see /llms.txt — with a raw-markdown version of every docs page at its URL plus .md.