Runtime healthGet runtime hook health

Get runtime hook health

Whether hooks are reporting for one agent surface, plus active hosts, active sessions, and the 24-hour event count.

curl -X GET "https://www.agentkeeper.dev/api/v1/claude-code/health?source=claude-code" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "ok": true,
  "source": "codex",
  "source_label": "Codex",
  "hooks_active": true,
  "hooks_stale": false,
  "hooks_never_connected": false,
  "last_seen_at": "2026-08-18T11:02:44.000Z",
  "last_hostname": "dev-laptop-01",
  "active_hosts": 34,
  "active_hosts_truncated": false,
  "active_sessions": 7,
  "active_sessions_truncated": false,
  "events_24h": 1284,
  "events_24h_truncated": false
}
GET
/api/v1/claude-code/health
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An AgentKeeper API key, sent as Authorization: Bearer ak_live_….

An AgentKeeper API key, sent as Authorization: Bearer ak_live_….
query
sourcestring

Agent surface to report on. Defaults to claude-code. tool is accepted as an alias.

Options: claude-code, claude-chat, cowork, cursor, windsurf, copilot, codex, gemini, antigravity
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An AgentKeeper API key, sent as Authorization: Bearer ak_live_….

Query Parameters

sourcestring

Agent surface to report on. Defaults to claude-code. tool is accepted as an alias.

Allowed values:claude-codeclaude-chatcoworkcursorwindsurfcopilotcodexgeminiantigravity

Responses

okboolean
sourcestring
source_labelstring
hooks_activeboolean

Reporting

hooks_staleboolean

Reported before

hooks_never_connectedboolean
last_seen_atstring,null
last_hostnamestring,null
active_hostsinteger
active_hosts_truncatedboolean

The real count exceeds the query cap.

active_sessionsinteger
active_sessions_truncatedboolean
events_24hinteger
events_24h_truncatedboolean