API ReferenceMetaDaemon health and contract handshake GET

Daemon health and contract handshake

Health and contract handshake endpoint — returns daemon version and apiVersion for compatibility checks.

1 min read

Response Body

`application/json`

`application/json`

curl -X GET "https://example.com/health"

{
  "ok": true,
  "apiVersion": "coven.daemon.v1",
  "covenVersion": "0.0.0",
  "capabilities": {
    "sessions": true,
    "events": true,
    "eventCursor": "sequence",
    "structuredErrors": true
  },
  "daemon": {
    "pid": 12345,
    "startedAt": "2026-05-09T12:00:00.000Z",
    "socket": "/Users/example/.coven/coven.sock"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Unexpected internal daemon error.",
    "details": {}
  }
}

Was this page helpful?No