Armalo Cloud
Open Cloud from the App
Open in the App. Connect from Settings → Developer when you work in your own tools. The CLI installs from npm as @armalo/cli@app.
Open the App
The live path is the App. If you work from your own tools, connect once from Settings → Developer, then use the connected developer tools (the armalo_cloud_readiness tool) for Cloud readiness checks.
The Armalo CLI installs from npm as @armalo/cli@app. Always use the @app tag: @armalo/cli without it belongs to a different product. The API & SDK reference covers signing in with the CLI.
Use the HTTP API
Send your Armalo API key as a bearer token. Every request and response uses JSON.
curl -X POST https://api.armalo.ai/v1/dev/sandboxes \
-H "Authorization: Bearer ak_live_..." \
-H "Content-Type: application/json" \
-d '{ "region": "us" }'Tier requirements
The shell capability is enabled for Solo, Growth, Scale, and Enterprise & Agency tiers. Starter-tier keys receive a 404.
Existing customers with Starter workspaces can keep using workspaces; the shell is opt-in, never a forced migration.
Endpoints
Four endpoints cover the whole shell lifecycle:
- POST /v1/dev/sandboxes — provision. Body: { "region": "<two-letter>" } (optional). Returns 201 with the sandbox object.
- GET /v1/dev/sandboxes — list. Returns { items: [...], total: <n> }.
- GET /v1/dev/sandboxes/:id — read one. Returns the sandbox object.
- DELETE /v1/dev/sandboxes/:id — stop. Returns 200 { ok: true }.
Each sandbox object includes its id, status, region, connect link, and expiry time. Responses never include bearer tokens or infrastructure details.
Questions?
What tier do I need?+
Solo, Growth, Scale, or Enterprise & Agency. Starter-only keys receive a 404.
What is the connect link?+
Each shell has one connect link on shell.armalo.ai, made of the region and the shell id. Open it in a browser or your editor.
Can I open multiple shells?+
Yes, up to your tier's concurrent shell ceiling. Solo is single-shell; Growth raises the cap; Scale and Enterprise & Agency negotiate further. The API returns 429 when you exceed the cap.
What happens to a stopped shell?+
Stop frees the compute but keeps your files. Starting a shell again can return the same id with your files; a fresh start returns a new id with no retained state.
Looking for a workspace instead of a shell? Starter, Growth, and Scale still ship the workspace surface alongside the shell. One subscription, both primitives.