Agents

Start, stop or restart an agent

post/agents/{agentId}/actions

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/agents/{agentId}/actions
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Path parameters

agentIdstring uuid required

Request body

action'start' | 'stop' | 'restart' required

Response

Done

idstring required
organizationIdstring required
projectIdstring nullable required
namestring required
kind'hermes' | 'openclaw' required
kindNamestring required
versionstring required
status'provisioning' | 'running' | 'stopped' | 'error' | 'deleting' | 'deleted' required
statusDetailstring nullable required
health'healthy' | 'unhealthy' | 'starting' | 'unknown' required
healthCheckedAtstring nullable required

ISO-8601 timestamp

billing'free_beta' | 'plan' required
alwaysOntrue required
createdAtstring required

ISO-8601 timestamp

updatedAtstring required

ISO-8601 timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.