---
title: "Set database storage backup schedule"
method: PUT
path: "/databases/{uuid}/storages/{storage_uuid}/backups"
tags: ["Databases"]
---

# Set database storage backup schedule

`PUT /databases/{uuid}/storages/{storage_uuid}/backups`

Create or replace the backup schedule for a database persistent volume or directory storage.

## Path parameters

- `uuid` string, required
- `storage_uuid` string, required

## Request body

- VolumeBackupScheduleRequest
  - `frequency` string, required
  - `enabled` boolean
  - `save_s3` boolean
  - `disable_local_backup` boolean
  - `stop_during_backup` boolean
  - `s3_storage_uuid` string, nullable
  - `retention_amount_locally` integer
  - `retention_days_locally` integer
  - `retention_max_storage_locally` number, float
  - `retention_amount_s3` integer
  - `retention_days_s3` integer
  - `retention_max_storage_s3` number, float
  - `timeout` integer

## Response `200`

Backup schedule replaced.

- VolumeBackupScheduleResponse
  - `uuid` string, required
  - `message` string, required
  - `storage_uuid` string, required
  - `storage_type` 'persistent' | 'directory', required
  - `frequency` string, required
  - `enabled` boolean, required
  - `save_s3` boolean, required
  - `disable_local_backup` boolean, required
  - `stop_during_backup` boolean, required
  - `s3_storage_uuid` string, nullable
  - `retention_amount_locally` integer, required
  - `retention_days_locally` integer, required
  - `retention_max_storage_locally` number, float, required
  - `retention_amount_s3` integer, required
  - `retention_days_s3` integer, required
  - `retention_max_storage_s3` number, float, required
  - `timeout` integer, required

## Other responses

- `201` — Backup schedule created.
- `400` — Invalid token.
- `401` — Unauthenticated.
- `403` — Forbidden.
- `404` — Resource not found.
- `422` — Validation error.

## Changes

- **2026-07-19** `08be5dc8e729` — 1 info
  - endpoint added
- **2026-07-19** `16dc4d4d2f00` — 1 breaking
  - api path removed without deprecation
- **2026-07-15** `a9dcb79ac8fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/databases/:uuid/storages/:storage_uuid/backups/put.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coollabsio/coolify/revisions/789e6ad3796c/schema)