Health

Liveness

GET /health

Always 200 {"status": "ok"} while the process serves requests. No authentication.

Authentication: None.

Response

200 The process is up (application/json)

Errors

Example

curl "https://api.machinemail.dev/health"

{
  "status": "ok"
}

Readiness

GET /health/ready

Pings the storage backend: 200 with status: ready when it answers, 503 with status: unavailable when it does not. checks.transport names the mail transport and checks.notify reports cross-machine notifications (informational, never part of readiness). No authentication.

Authentication: None.

Response

200 Ready (application/json)

Errors

Example

curl "https://api.machinemail.dev/health/ready"

{
  "status": "ready",
  "checks": {
    "storage": false,
    "transport": "string",
    "notify": "listening"
  }
}