Browse API docsStatus page

Status page and files

Source freshness in three forms: a page for people, JSON for scripts and markdown for agents.

URLs

URLWhat it serves
/statusThe status page to browsers. It answers JSON to anything that does not prefer text/html in Accept, and markdown when text/markdown ranks higher.
/status.jsonAlways JSON, the same as /api/v1/status.
/status.mdAlways markdown: the page's tables as plain text, for agents and terminals.

Parameters

assertstringOptional
1 answers 503 instead of 200 when summary.ok is false, so an uptime monitor alerts even if the scheduler stopped.

All three URLs take assert. The page also answers 503 when the status read itself fails.

Uptime monitoring

Point a monitor at /status.json?assert=1 and alert on anything but 200. It fails when the scheduler has not run for 5 minutes, a completed failure has not recovered, a running tick exceeded its 2-minute lease, or a source is Stale. A plain health check cannot see these failures.

Request
curl -fsS -o /dev/null -G \
  "https://claudemon.com/status.json" \
  --data-urlencode "assert=1"

Headers

Cache-Control
no-cache.
Vary
Accept on /status, which picks its format from it.