add stream heartbeat

1 files changed, 2 insertions, 1 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 387a7ac..701cdf9 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -329,7 +329,8 @@ paths:
       description: |
         Newline-delimited JSON: one event with the current value, then one whenever
         the resolved value changes (by a local write or by sync). The connection stays
-        open.
+        open; while nothing changes, a blank line every `--stream-heartbeat` (30 s)
+        keeps proxies from closing it: skip blank lines.
       responses:
         '200':
           description: Event stream.