Skip to main content
POST
Exec hermes CLI

Authorizations

Authorization
string
header
required

Clerk session JWT for the web app (active organization required), or an organization-scoped SEAOTTER access key (so_…) from POST /api/v1/api-keys for programmatic / docs try-it / MCP use. The same so_… value is both Authorization: Bearer so_… and SEAOTTER_API_KEY.

Path Parameters

agent_id
string<uuid>
required

Body

application/json

Run an allowlisted hermes <argv…> command in the agent pod (no shell).

argv
string[]
required

Arguments after the hermes binary, e.g. ["status"] or ["config","show"]

Required array length: 1 - 32 elements
Example:
confirm
boolean
default:false

Required true for tier-3 destructive commands

timeout_seconds
integer
default:60
Required range: 1 <= x <= 300

Response

Successful Response

exit_code
integer
required
stdout
string
required
stderr
string
required
argv
string[]
required
duration_ms
integer
required
tier
integer
required