Create Scheduler
Creates a new scheduler.
Authentication
Requires authentication. Pass your API key via X-API-Key or Authorization: Bearer header.
Request Body
1{
2 "id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3 "display_name": "my-scheduler"
4}
Example Request
1curl -X POST "https://api.hola.cloud/schedulers" \
2 -H "X-API-Key: YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
6 "display_name": "my-scheduler"
7 }'
Example Response
1HTTP/1.1 201 Created
2Content-Type: application/json
1{
2 "scheduler": {
3 "id": "sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
4 "ready": true,
5 "scheduled": 0,
6 "inflight": 0,
7 "display_name": "my-scheduler",
8 "created_at": "2025-06-21T10:00:00Z",
9 "updated_at": "2025-06-21T10:00:00Z"
10 }
11}
Error Codes
| Status | Code | Description |
|---|---|---|
| 400 | invalid_json | Invalid JSON payload |
| 400 | validation_error | Missing or invalid id, display_name, or description |
| 401 | unauthorized | Missing or invalid API key |
| 409 | conflict | Scheduler already exists |
| 500 | internal_error | Internal server error |
Comments