Skip to main content
POST
Migrate Agent Sandbox

Authorizations

Authorization
string
header
required

Clerk session JWT for the web app, or a control-plane API key (so_…) from POST /api/v1/api-keys for programmatic / docs try-it use.

Path Parameters

agent_id
string<uuid>
required

Body

application/json

Enable or disable gVisor RuntimeClass on an existing tenant (preserves PVC).

enabled
boolean
default:true

Response

Successful Response

id
string<uuid>
required

Agent UUID

name
string
required
status
enum<string>
required

pending | provisioning | running | paused | stopped | error | deleting

Available options:
pending,
provisioning,
running,
paused,
stopped,
error,
deleting
namespace
string
required

Kubernetes namespace (agent-{id})

resource_plan
enum<string>
required
Available options:
starter,
pro,
enterprise
config
AgentConfigPublic · object
required

Documented subset of agent.config returned on AgentOut (extra keys allowed).

created_at
string<date-time>
required
updated_at
string<date-time>
required
env_vars
Env Vars · object
error_message
string | null
dashboard_url
string | null
Example:

"https://my-hermes-abcd1234.agents.seaotter.dev"

api_url
string | null
dashboard_handoff_url
string | null
dashboard_username
string | null
hostname
string | null