---
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.

---

[API](https://skmtc.net/coollabsio/apis/coolify.md) · [All operations](https://skmtc.net/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coollabsio/coolify/versions/08be5dc8e729/schema)