Endpoint Health-Check Settings
Reads and updates the per-endpoint health-check configuration: whether probing is enabled, which path the prober hits, and how often. Probe results are surfaced through GET /v1/endpoints/{id}/health.
Health checks are disabled by default. Endpoints opt in by setting enabled = true. Health checks are also HTTP only; the API rejects enable requests for endpoints whose protocol is tcp or udp.
Path parameters
PUT body
All fields are optional. Only fields present in the body are updated — partial updates are supported (no need to send the full document).
true on a non-HTTP endpoint returns 400./. Max 255 characters. Send null or empty string to clear (the worker falls back to /).[60, 86400] (1 minute to 1 day). Values outside the range return 400.Response (200 OK)
Both GET and successful PUT return the current effective configuration, including defaults the worker would apply when the persisted values are NULL.
http, https, unified, or empty (older rows). TCP/UDP endpoints can't be probed (see supported below).true when the worker can probe this endpoint type (HTTP / HTTPS / unified / null). false for TCP/UDP — clients use this to gate the UI./ when the persisted column is NULL or empty.interval_seconds (currently 60).interval_seconds (currently 86400 — 1 day).Propagation latency
Changes take effect within about 30 seconds — the worker reconciles its in-Redis schedule against the database on that cadence. Disabling does not delete the cached "last check" verdict immediately; that ages out after 7 days unless overwritten by a fresh probe.
Errors
interval_seconds out of range, path doesn't start with / or exceeds 255 chars, body sets enabled = true on a TCP/UDP endpoint, or no fields were present.