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

Leave a comment