---
title: "Create Backup"
method: POST
path: "/databases/{uuid}/backups"
tags: ["Databases"]
---

# Create Backup

`POST /databases/{uuid}/backups`

Create a new scheduled backup configuration for a database

## Path parameters

- `uuid` string, required

## Request body

- object
  - `frequency` string, required — Backup frequency (cron expression or: every_minute, hourly, daily, weekly, monthly, yearly)
  - `enabled` boolean — Whether the backup is enabled
  - `save_s3` boolean — Whether to save backups to S3
  - `s3_storage_uuid` string — S3 storage UUID (required if save_s3 is true)
  - `databases_to_backup` string — Comma separated list of databases to backup
  - `dump_all` boolean — Whether to dump all databases
  - `backup_now` boolean — Whether to trigger backup immediately after creation
  - `database_backup_retention_amount_locally` integer — Number of backups to retain locally
  - `database_backup_retention_days_locally` integer — Number of days to retain backups locally
  - `database_backup_retention_max_storage_locally` number — Max storage (GB) for local backups
  - `database_backup_retention_amount_s3` integer — Number of backups to retain in S3
  - `database_backup_retention_days_s3` integer — Number of days to retain backups in S3
  - `database_backup_retention_max_storage_s3` number — Max storage (GB) for S3 backups
  - `timeout` integer — Backup job timeout in seconds (min: 60, max: 36000)

## Response `201`

Backup configuration created successfully

- object
  - `uuid` string, uuid
  - `message` string

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `404` — Resource not found.
- `422` — Validation error.

## Changes

- **2026-04-28** `a4892b2ef9af` — 2 info
  - the `database_backup_retention_max_storage_locally` request property type/format was generalized from `integer`/`` to `number`/``
  - the `database_backup_retention_max_storage_s3` request property type/format was generalized from `integer`/`` to `number`/``
- **2026-03-31** `e3675d1259b1` — 1 info
  - added the new optional request property `timeout`
- **2026-03-16** `385ee693a76d` — 2 breaking, 1 warning
  - the `database_backup_retention_max_storage_locally` request property type/format changed from `number`/`` to `integer`/``
  - the `database_backup_retention_max_storage_s3` request property type/format changed from `number`/`` to `integer`/``
  - removed the request property `timeout`

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/databases/:uuid/backups/post.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/ccd37e78d00a/schema)