Skip to content

GET /api/v1/cycles/status

Status: GA Access: token required API contract: 0.3.0 · capability 2026-09-03.1 View as Markdown Open in Claude Open in ChatGPT

Cron Status

Cron + last/next run summary. Settings-derived; future Cron service SPEC will replace with real cron state from a cron_runs table.

Auth: Authorization: Bearer <token> required

Terminal window
curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/cycles/status" \
-H "Authorization: Bearer <token>"

The contract carries no example for this response; schema: CronStatus. Field-level shape: interactive explorer.

CronStatus — Successful Response

FieldTypeDescription
last_run_atstring | null
last_run_labelstring
last_run_status"ok" | "warn" | "fail" | "unknown"
next_run_atstring
next_run_in_secondsinteger
paused_sc_idsarray of integer
schedulestring
timezonestring

None.

CodeMeaningBody
401Missing or invalid authentication credentialsErrorResponse

Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.