Skip to content

Tenant office worker and queue runtime health

GET/office/runtime/health

Returns a health snapshot of the office suite worker process and render queue for this tenant. Use to diagnose rendering delays or worker failures before investigating individual failed jobs. Called periodically by the monitoring dashboard.

Request

This endpoint takes no parameters and no request body.

Responses

200 Office runtime health snapshot

Content type application/json, object · OfficeRuntimeHealthV1.

FieldTypeRequiredDescription
worker_statusstringNo

Overall status of the background render worker.

One of: "healthy", "degraded", "down"

queue_depthintegerNo

Number of jobs currently waiting in the render queue.

processingintegerNo

Number of jobs currently being actively processed.

failed_last_hourintegerNo

Number of render jobs that failed in the last 60 minutes.

average_render_msinteger, nullableNo

Rolling average render time in milliseconds over the last 100 completed jobs.

last_successful_render_atstring (date-time), nullableNo

Timestamp of the most recently successfully completed render job.

libreoffice_versionstring, nullableNo

Version string of the LibreOffice runtime used for document conversion.

Example

{
  "worker_status": "healthy",
  "queue_depth": 3,
  "processing": 1,
  "failed_last_hour": 0,
  "average_render_ms": 2340,
  "last_successful_render_at": "2026-04-08T11:58:00Z",
  "libreoffice_version": "7.6.5"
}

503 Office worker is unhealthy or unreachable

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/office/runtime/health" \
  -H "Accept: application/json"
Loading