Skip to main content
POST
/
agent
Report health
curl --request POST \
  --url https://api.example.com/agent \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "status": "<string>",
  "checks": {}
}
'

​
Request

Authenticated with the agent’s bootstrap token. 
{
  "action": "health",
  "status": "healthy",
  "latency_ms": 45,
  "checks": {
    "network": { "status": "healthy", "latency_ms": 45 },
    "disk": { "status": "healthy", "available_gb": 120 },
    "token": { "status": "healthy", "expires_in_days": 25 }
  },
  "openclaw_version": "4.2.0"
}
​
action
string
required
Must be "health".
​
status
string
required
One of: healthy, degraded, unhealthy.
​
checks
object
Detailed sub-check results as JSON.

​
Response

{
  "recorded": true,
  "timestamp": "2026-03-28T07:00:00Z"
}