Agent sessions
21 operations.
List agent sessions (live status, repo, harness)
GET /api/v1/agent-sessions
Spawn an interactive Claude Code / Codex agent session (its own microVM sandbox)
POST /api/v1/agent-sessions
Get an agent session (state, online, auth link, queued turns)
GET /api/v1/agent-sessions/{id}
Update an agent session's settings (title, model, idle window)
PUT /api/v1/agent-sessions/{id}
Destroy an agent session (tears down the sandbox and deletes the conversation)
DELETE /api/v1/agent-sessions/{id}
Submit the CLI OAuth code shown after opening the session's auth link
POST /api/v1/agent-sessions/{id}/auth-code
End a background shell the agent started (a Bash run in the background), by its command; the turn keeps running
POST /api/v1/agent-sessions/{id}/background-tasks/stop
Stop the running turn only (the composer stop button) — sandbox and conversation stay alive
POST /api/v1/agent-sessions/{id}/interrupt
Read the session conversation (cursor-paged; pass next as ?after=)
GET /api/v1/agent-sessions/{id}/messages
Send a user turn to the session's CLI agent (wakes a paused session)
POST /api/v1/agent-sessions/{id}/messages
Pause an agent session (snapshots + frees the sandbox; a message wakes it)
POST /api/v1/agent-sessions/{id}/pause
Resume a paused agent session
POST /api/v1/agent-sessions/{id}/resume
Session live-output stream (SSE)
GET /api/v1/agent-sessions/{id}/stream
Interactive terminal into the session sandbox (WebSocket)
GET /api/v1/agent-sessions/{id}/terminal
Session usage: context-window footprint + provider subscription limits
GET /api/v1/agent-sessions/{id}/usage
List a repository's branches (default branch flagged first) for the session branch picker
GET /api/v1/agent-sessions/branches
Session model + reasoning-effort choices from the CLI's own vocabulary
GET /api/v1/agent-sessions/cli-options
Browse per-repository session memory (living docs distilled from wrapped sessions)
GET /api/v1/agent-sessions/memory
Edit one session-memory file (human curation; empty content deletes the file)
PUT /api/v1/agent-sessions/memory
Reset session memory — one file (?file=) or the whole repository (files + recaps)
DELETE /api/v1/agent-sessions/memory
Browse the GitHub connector's repositories — the ADD-repository dialog's source (409 connector_required when none)
GET /api/v1/agent-sessions/repos