---
title: "Set the backup schedule"
method: PUT
path: "/clusters/{cluster_id}/backup-schedule"
tags: ["Cluster Backups"]
---

# Set the backup schedule

`PUT /clusters/{cluster_id}/backup-schedule`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/clusters/{cluster_id}/backup-schedule`
- Auth: API key in header `API-Key`

Sets the daily automatic backup time in UTC, or with `null` returns it to the start of
the cluster's maintenance window.

Required scope: `clusters:backups:write`

## Path parameters

- `cluster_id` string, uuid, required

## Headers

- `API-Version` '2026-06-01.beta', required

## Request body

- UpdateBackupScheduleRequest
  - `time_of_day` string, required: A time of day in 24-hour UTC, `HH:MM`.

## Response `200`

The request has succeeded.

- BackupSchedule
  - `time_of_day` string, required: A time of day in 24-hour UTC, `HH:MM`.
  - `source` 'custom' | 'maintenance_window', required
  - `default_time_of_day` string, required: A time of day in 24-hour UTC, `HH:MM`.

## Other responses

- `401`: Access is unauthorized.
- `402`: Client error
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `422`: Client error
- `429`: Client error
- `500`: Server error
- `501`: Server error

---

[API](https://skmtc.dev/skycloak/apis/skycloak-public-api.md) · [All operations](https://skmtc.dev/skycloak/apis/skycloak-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skycloak/apis/skycloak-public-api/revisions/33a69e2ce35f?raw)