Skip to content
Management API Reference

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.

OAuth scopes

  • database:write

This endpoint is only available on the following plans:

  • Enterprise

Path parameters

  • ref
    Required
    string

    Project ref

Body

  • schedule_for
    Required
    string

Response codes

  • 200
  • 400
  • 401
  • 402
  • 403
  • 404
  • 429
  • 500

Response (200)

1
{
2
  "schedule_for": "04:00:00",
3
  "updated_at": "2026-05-04T14:40:44+00:00"
4
}