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

The fine-grained token must include the following permissions to access this endpoint:

  • backups_write

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
}