List Tasks
Lists tasks for a scheduler, with separate pagination for scheduled and in-flight tasks.
Authentication
This endpoint is public. No authentication required.
Path Parameters
| Parameter |
Type |
Description |
| id |
string |
The unique identifier of the scheduler |
Query Parameters
| Parameter |
Type |
Description |
| scheduled_page |
integer |
Page number for scheduled tasks (default: 1) |
| scheduled_per_page |
integer |
Items per page for scheduled tasks (default: 20) |
| inflight_page |
integer |
Page number for in-flight tasks (default: 1) |
| inflight_per_page |
integer |
Items per page for in-flight tasks (default: 20) |
| search |
string |
Search tasks by payload content |
| label |
string |
Filter by label (format: key:value) |
Example Request
1curl "https://api.hola.cloud/schedulers/sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks?label=priority:high"
Example Response
1HTTP/1.1 200 OK
2Content-Type: application/json
1{
2 "scheduled": [
3 {
4 "id": "task-x1y2z3",
5 "future": "2025-06-21T12:01:01Z",
6 "labels": ["project:onboarding", "priority:high"]
7 }
8 ],
9 "inflight": [],
10 "scheduled_meta": {
11 "total": 1,
12 "page": 1,
13 "per_page": 25,
14 "total_pages": 1
15 },
16 "inflight_meta": {
17 "total": 0,
18 "page": 1,
19 "per_page": 25,
20 "total_pages": 0
21 }
22}
Error Codes
| Status |
Code |
Description |
| 400 |
validation_error |
Invalid pagination or filters |
| 404 |
not_found |
Scheduler not found |
| 500 |
internal_error |
Internal server error |
Comments