FousDocs

API reference

Get Health

GET /health

GET/health

Operational readiness. A degraded response uses the health envelope, not an execution error.

Authentication

This endpoint does not require an API key.

Responses

200

Healthy

application/json

FieldTypeRequiredDescription
status"ok" · "degraded"Yes
servicestringYes
timestampstringYes
uptime_secondsintegerYes
checksobjectYes

Full schema:

json
{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "ok",
        "degraded"
      ]
    },
    "service": {
      "type": "string"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time"
    },
    "uptime_seconds": {
      "type": "integer"
    },
    "checks": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "status",
    "service",
    "timestamp",
    "uptime_seconds",
    "checks"
  ],
  "additionalProperties": false
}

503

Degraded

application/json

FieldTypeRequiredDescription
status"ok" · "degraded"Yes
servicestringYes
timestampstringYes
uptime_secondsintegerYes
checksobjectYes

Full schema:

json
{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "ok",
        "degraded"
      ]
    },
    "service": {
      "type": "string"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time"
    },
    "uptime_seconds": {
      "type": "integer"
    },
    "checks": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "status",
    "service",
    "timestamp",
    "uptime_seconds",
    "checks"
  ],
  "additionalProperties": false
}