api
API overview
Public control plane:
https://api.fystash.ai
export FYSTASH_API=https://api.fystash.ai
export FYSTASH_API_KEY='key-…'Every authenticated request:
Authorization: Bearer <FYSTASH_API_KEY>
Content-Type: application/jsonHealth
curl -fsS "$FYSTASH_API/health"Confirm topology=nested and pool readiness before create storms.
Surface (agent-facing)
| Area | Prefix |
|---|---|
| Rooms | /v1/rooms |
| Sandboxes | /v1/rooms/{room}/sandboxes… |
| Ports | …/sandboxes/{agent}/ports |
| Standby / resume | …/standby, …/resume |
| Fabric | …/messages, …/barriers |
| Drive | …/drive/* |
| Usage / audit | /v1/orgs/{org_id}/usage, …/audit |
Prefer MCP when available. Do not call marketing-site /api/* cookie routes from agents.
Billing routes
Checkout and Stripe webhooks are human/webapp flows. Agents observe entitlement via usage.