/schedules/{id}Update a schedule
Nested backup-format and encryption objects merge one level deep; null resets them to defaults.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Resource ID.
Request body
application/jsonrequiredKubernetes requests and limits of the restore's database container (the sidecar that imports the dump and answers the health probes). Every value is optional and stands alone: nothing is derived, no default is applied. null or {} sets none (the container then has no requests or limits). A request must not exceed the limit of the same resource. With only a limit set, Kubernetes uses it as the request too. Database schedules only; a file schedule with values is rejected. If no node has the requested CPU or memory free for 300 s the check ends failed_infra with exit code 49.
Five-field cron expression evaluated in UTC. A range in the minute field (for example 10-19 4 * * 1) is replaced by one minute chosen at random inside that range when the schedule is saved; the stored expression is what the API returns.
Values: "hourly" · "daily" · "weekly"
Database schedules only; file schedules do not accept gates.
Values: "never" · "always" · "on-error"
Responses
Updated schedule.
{
"status": "success",
"data": {
"id": "65f0c7a9a7d6b4e2c1234567",
"project_id": "65f0c7a9a7d6b4e2c1234567",
"name": "string",
"description": "string",
"worker_id": "65f0c7a9a7d6b4e2c1234567",
"worker": {
"id": "65f0c7a9a7d6b4e2c1234567",
"name": "string",
"country": "string"
},
"scratch_size_gi": "string",
"database_resources": {
"cpu_request_millicores": "string",
"cpu_limit_millicores": "string",
"memory_request_mib": "string",
"memory_limit_mib": "string"
},
"source": {},
"source_id": "65f0c7a9a7d6b4e2c1234567",
"source_name": "string",
"db_type": "string",
"db_version": "string",
"schedule_mode": "hourly",
"cron": "string",
"gates": [
{
"name": "string",
"type": "restore_status",
"operator": "eq",
"successful": true
}
],
"notify_mode": "never",
"notification_channels": [
{
"id": "65f0c7a9a7d6b4e2c1234567"
}
],
"status": "active",
"next_run": "2026-01-01T00:00:00Z",
"last_run_at": "2026-01-01T00:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z"
}
}The request body, parameter, filter, cursor, or project-scoping pattern is invalid.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
Authentication is missing or the credential is invalid, inactive, expired, or lacks the required scope.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
The authenticated caller is not allowed to perform this operation.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
The resource was not found or is outside the caller's project.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
The requested change conflicts with the resource's current state or dependencies.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
A required service is temporarily unavailable.
{
"status": "error",
"message": "string",
"code": "string",
"detail": {},
"quota": {
"key": "string",
"limit": 1,
"used": 1
},
"feature": "string",
"dependency": "string"
}Stable machine-readable code when the error defines one.
Powered by heyo