API reference

Shells

Your sandboxes: list them.

Operations: 1
Base path: https://os.one.ml/api/v1/shells
Scopes: shells:read
API keys: 1 refused to API keys
SDK: genesis.call('shells_listShells', …) · helpers under genesis.shells
CLI: genesis shells
MCP: 1 tools

Operations

Operation	Endpoint	API key
List your Shells (sandboxes)	GET`/shells`	API keys refused

Shells

List your Shells (sandboxes)

GET/v1/shells/shells

shells:readAPI keys refusedshells_listShells

Sandbox instances in the selected organization and project. Needs shells:read.

Responses

200Shells in the selected project
Response fields
- product"shells"required
- instancesobject[]required
- instances[].[].idstringrequired
- instances[].[].omegaDeploymentIdstringrequired
- instances[].[].namestringrequired
- instances[].[].kindstringrequired
  desktop (Rigs), browser (Panes) or sandbox (Shells)
- instances[].[].statusstringrequired
- instances[].[].stagestringrequired
  queued, placed, running, failed, unknown or another producer stage
- instances[].[].detailUrlstring
- instances[].[].regionstring | null
- instances[].[].tierstring | null
- instances[].[].runtimestring | null
- instances[].[].createdAtstring | null
- instances[].[].updatedAtstring | null
403Signed organization and project selection required
503Shells private admission unavailable
4xx 5xxThe error envelope.

curl "https://os.one.ml/api/v1/shells/shells" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

import { Genesis } from '@lifesi/genesis'

const genesis = new Genesis({ apiKey: process.env.GENESIS_API_KEY })
const result = await genesis.call('shells_listShells')

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "shells_listShells",
    "arguments": {}
  }
}

One Superintelligence, Inc. · Built from Genesis 0.1.12 and the live gateway on 2026-10-20. Support