API ReferenceTask Runs
Task Runs
Create one-off task runs and inspect execution state.
A Task Run is one concrete execution instance created by a schedule, event fanout, or direct API call. It is runtime work, not a reusable task definition.
Task Run
Where it sits in the pipeline
Tasks are concrete execution instances. They may be created by schedules, event fanout, or direct API calls.
Remember this distinction
A Task Run is runtime state, not a reusable job definition.
These endpoints are generated from edgecron/docs/openapi.json and follow the shared EdgeCron response envelope.
| Method | Endpoint | Description |
|---|---|---|
| POST | /tasks | Create a task run |
| GET | /tasks | List task runs |
| GET | /tasks/{id} | Get a task run |
| POST | /tasks/{id}/cancel | Cancel a task run |