Agents

Create a private agent: an isolated, always-on Hermes Agent or OpenClaw with a persistent workspace. Optionally its model (your own provider key, or Hostingsurge AI when available) and Telegram/Discord with the user ids allowed to talk to it. Keys and tokens are write-only.

post/agents

Request

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

Query parameters

orgIdstring

Organization id (required when you belong to several)

Request body

namestring required
kind'hermes' | 'openclaw' required

Response

Created

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.