POST /api/v1/runs/schedules/{schedule_id}/fire
Fire Now
fire now (same seam as the tick-loop / an external Cloud Scheduler).
Auth: Authorization: Bearer <token> required
Request
Section titled “Request”curl -sS -X POST "https://entherium.duckdns.org:8443/api/v1/runs/schedules/<schedule_id>/fire" \ -H "Authorization: Bearer <token>"Response 200
Section titled “Response 200”The contract carries no example for this response; schema: ScheduleFireResult. Field-level shape: interactive explorer.
Returns
Section titled “Returns”ScheduleFireResult — Successful Response
| Field | Type | Description |
|---|---|---|
errors | array of string | |
fired | integer | |
run_guids | array of integer | |
schedule_id | integer | |
skipped | integer |
Parameters
Section titled “Parameters”| Parameter | In | Required | Type | Default | Constraints | Description |
|---|---|---|---|---|---|---|
schedule_id | path | yes | integer | — | — | |
Idempotency-Key | header | no | string | — | uuid | Optional. |
Errors
Section titled “Errors”| Code | Meaning | Body |
|---|---|---|
401 | Missing or invalid authentication credentials | ErrorResponse |
422 | Validation Error | HTTPValidationError |
Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.