snapshot of https://github.com/jitsi/jitsi-videobridge.git @ fcbf741c646bc237d2ed85a1e86910532532b831 (2026-09-15)

doc/health-checks.md

@@ -0,0 +1,19 @@
+The REST API allows querying Videobridge whether it deems itself in a healthy state (i.e. the application is operational and the functionality it provides should perform as expected) at the time of the query or not. Videobridge performs periodic internal tests, and returns the latest result in response to requests to the `/about/health` endpoint.
+
+<table>
+  <tr>
+    <th>HTTP Method</th>
+    <th>Resource</th>
+    <th>Response</th>
+  </tr>
+  <tr>
+    <td><code>GET</code></td>
+    <td><code>/about/health</code></td>
+    <td>
+      <ul>
+        <li><code>200 OK</code> The service is healthy. The response is with <code>Content-Type: application/json</code> but no JSON value is provided i.e. <code>Content-Length: 0</code>.</li>
+        <li><code>500 Internal Server Error</code> or any other <code>5xx</code> status code if Videobridge determined that it is in an unhealthy state.</li>
+      </ul>
+    </td>
+  </tr>
+</table>