Sign in

v1

latestOpenAPI 3.0.02026-07-17112116167.8 KB
Agent

Inspect the calling agent identity (proxy_token auth)

get/api/agent/whoami

Response

OK

display_namestring required
rolestring required
sandbox_idstring required
sandbox_statusstring required

SandboxStatus is the current sandboxes.status column verbatim — one of creating / running / pausing / paused / resuming / offline / deleting (see internal/sbxstore/state.go), or "" for legacy rows where the field was never set. The server always populates this field on 200 responses.

short_idstring required
user_idstring required
workspace_idstring required
workspace_namestring required

Example response

{
  "display_name": "Alice Driver",
  "role": "developer",
  "sandbox_id": "sbx_456",
  "sandbox_status": "running",
  "short_id": "alice-driver-01",
  "user_id": "u_abc123",
  "workspace_id": "ws_xyz789",
  "workspace_name": "Alice's Workspace"
}