---
title: "Create Backup"
method: POST
path: "/v1/postgres/{postgres_cluster_id}/backups"
tags: ["Postgres Clusters"]
---

# Create Backup

`POST /v1/postgres/{postgres_cluster_id}/backups`

Create a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.

## Path parameters

- `postgres_cluster_id` string, required

## Request body

- CreatePostgresBackupRequest
  - `type` 'full' | 'incr' | 'diff', required — Backup type.

## Response `202`

Accepted

## Other responses

- `404` — Cluster not found
- `409` — A backup is currently running

## Changes

- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/postgres/:postgres_cluster_id/backups/post.md)

---

[API](https://skmtc.dev/machines/apis/machines-api.md) · [All operations](https://skmtc.dev/machines/apis/machines-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/machines/machines-api/revisions/80746f322f20/schema)