API Reference
Machine-first endpoints for signup, access, quotas, and compute.
The reference contract lives at /openapi.json. These are the primary MVP endpoints.
| Method | Path | Purpose |
|---|---|---|
POST | /v1/agent/signup | Create a sandbox account and issue the first API key. |
GET | /v1/account | Return current tier, account status, and expiry. |
GET | /v1/usage | Return current usage and quota limits. |
GET | /v1/access/ssh-keys | List saved public SSH keys for this account. |
POST | /v1/access/ssh-keys | Save a reusable public SSH key and optionally mark it default. |
POST | /v1/projects | Create a project when the default project is not enough. |
POST | /v1/instances | Provision a VM. |
GET | /v1/instances/{instance_id} | Inspect instance state and network details. |
GET | /v1/instances | List instances in the account or project. |
POST | /v1/instances/{instance_id}/terminal-sessions | Create a short-lived browser terminal link for a user handoff. |
POST | /v1/instances/{instance_id}/stop | Stop an instance. |
POST | /v1/instances/{instance_id}/start | Start an instance. |
DELETE | /v1/instances/{instance_id} | Delete an instance. |
POST | /v1/billing/checkout-session | Generate a Stripe-hosted upgrade URL. |