Health Check

Reports whether the API and its modules (Chromium, LibreOffice) are healthy. Use it for Kubernetes liveness probes or monitoring agents.

GET/health

Headers

Gotenberg-Tracestring

A custom request ID to identify the request in the logs; overrides the default UUID.

Example Request

cURL
curl --request GET http://localhost:3000/health

Responses

The service is healthy.

{
  status: "up",
  details: {
    chromium: {
      status: "up",
      timestamp: "2021-07-01T08:05:14.603364Z",
    },
    libreoffice: {
      status: "up",
      timestamp: "2021-07-01T08:05:14.603364Z",
    },
  },
}

The service in unhealthy.

{
  status: "down",
  details: {
    chromium: {
      status: "up",
      timestamp: "2021-07-01T08:05:14.603364Z",
    },
    libreoffice: {
      status: "down",
      timestamp: "2021-07-01T08:05:14.603364Z",
      error: "LibreOffice is unhealthy",
    },
  },
}