Schedules

Create, update, execute and delete schedules and their tasks.

GET/servers/:id/schedules

List all server schedules.

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/schedules" \
  -H "Authorization: Bearer rsk_your_key"

Create Schedule

Limit-checked: Schedule limit per plan

Body Parameters

Name	Type	Required	Description
`action`	"create"	Yes
`name`	string	Yes	Schedule name
`minute`	string	Yes	Cron minute (e.g. 0, */15)
`hour`	string	Yes	Cron hour
`day_of_month`	string	Yes	Cron day of month
`month`	string	Yes	Cron month
`day_of_week`	string	Yes	Cron day of week
`is_active`	boolean	No	Active (default: true)
`only_when_online`	boolean	No	Only when online (default: false)

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/schedules" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create",
    "name": "Daily Restart",
    "minute": "0", "hour": "4",
    "day_of_month": "*", "month": "*", "day_of_week": "*"
  }'

Update Schedule

Body Parameters

Name	Type	Required	Description
`action`	"update"	Yes
`scheduleId`	string	Yes	Schedule ID
`name`	string	No	New name
`is_active`	boolean	No	Active/Inactive
`minute`	string	No	Cron minute
`hour`	string	No	Cron hour
`day_of_month`	string	No	Cron day of month
`month`	string	No	Cron month
`day_of_week`	string	No	Cron day of week
`only_when_online`	boolean	No	Only when online

Delete / Execute Schedule

Body Parameters

Name	Type	Required	Description
`action`	"delete" \| "execute"	Yes	Delete or immediately execute schedule
`scheduleId`	string	Yes	Schedule ID

Create Task

Body Parameters

Name	Type	Required	Description
`action`	"create_task"	Yes
`scheduleId`	string	Yes	Schedule ID
`taskAction`	string	Yes	command, power, backup or delete_files
`payload`	string	No	Command or parameter for the action
`time_offset`	number	No	Delay in seconds (default: 0)
`continue_on_failure`	boolean	No	Continue on failure (default: false)
`sequence_id`	number	No	Sequence order (default: 1)

curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/schedules" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_task",
    "scheduleId": "1",
    "taskAction": "power",
    "payload": "restart",
    "sequence_id": 1
  }'

Update Task

Body Parameters

Name	Type	Required	Description
`action`	"update_task"	Yes
`scheduleId`	string	Yes	Schedule ID
`taskId`	string	Yes	Task ID
`taskAction`	string	No	New action
`payload`	string	No	New command/parameter
`time_offset`	number	No	New delay
`continue_on_failure`	boolean	No	Continue on failure
`sequence_id`	number	No	New sequence

Delete Task

Body Parameters

Name	Type	Required	Description
`action`	"delete_task"	Yes
`scheduleId`	string	Yes	Schedule ID
`taskId`	string	Yes	Task ID