Health · MachineMail Docs
Liveness
Health checks need no authentication.
| Method | Path | Summary |
|---|---|---|
GET |
/health |
Liveness |
GET |
/health/ready |
Readiness |
Liveness
http
GET /health
Always 200 {"status": "ok"} while the process serves requests. No authentication.
Authentication: None.
Response
200 The process is up (application/json)
| Field | Description |
|---|---|
status |
"ok" (Required) |
Errors
| Status | Meaning |
|---|---|
500 |
Unexpected server error. |
Example
Request
curl "https://api.machinemail.dev/health"
Response 200
{
"status": "ok"
}
Readiness
http
GET /health/ready
Pings the storage backend: 200 with status: ready (checks.storage: true) when it answers, 503 with status: unavailable when it does not. No authentication.
Authentication: None.
Response
200 Ready (application/json)
| Field | Description |
|---|---|
status |
"ready" |
checks |
object (Required) - The checks behind status. |
Errors
| Status | Meaning |
|---|---|
500 |
Unexpected server error. |
503 |
Not ready: storage did not answer |
Example
Request
curl "https://api.machinemail.dev/health/ready"
Response 200
{
"status": "ready",
"checks": {
"storage": true
}
}