---
title: "Updates the backup schedule time for a project"
method: PATCH
path: "/v1/projects/{ref}/database/backups/schedule"
tags: ["Database"]
---

# Updates the backup schedule time for a project

`PATCH /v1/projects/{ref}/database/backups/schedule`

Sets the time at which the daily backup runs. The change takes effect on the next backup window that includes the new time. If the new time has already passed for today, the first backup at the new time will occur the following day. It can only be updated 3 times per 24 hours.

## Path parameters

- `ref` string, required

## Request body

- V1UpdateBackupScheduleBody
  - `schedule_for` string, required — Time of day to schedule daily backups, in UTC. Format: HH:MM:SS.

## Response `200`

- V1BackupScheduleResponse
  - `schedule_for` string, required — Time of day to schedule daily backups, in UTC. Format: HH:MM:SS.
  - `updated_at` string, date-time, required — Timestamp of when the backup schedule was last updated.

## Other responses

- `400` — Invalid schedule_for format
- `401` — Unauthorized
- `402` — This feature requires the Enterprise organization plan.
- `403` — Forbidden action
- `404` — Project or backup schedule not found
- `429` — Rate limit exceeded
- `500` — Failed to update backup schedule

---

[API](https://skmtc.dev/supabase/apis/management-api.md) · [All operations](https://skmtc.dev/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supabase/management-api/revisions/a7cb39418064/schema)