Agents

Rename an agent or change its model connection or channels (null disconnects a channel). A running agent restarts to use them.

patch/agents/{agentId}

Request

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

Path parameters

agentIdstring uuid required

Request body

namestring

Response

Saved

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.