---
title: "Create database cluster backup"
method: POST
path: "/namespaces/{namespace}/database-cluster-backups"
tags: ["Backup"]
---

# Create database cluster backup

`POST /namespaces/{namespace}/database-cluster-backups`

This API creates a new database cluster backup in the specified `namespace`.

## Path parameters

- `namespace` string, required

## Request body

- DatabaseClusterBackup — DatabaseClusterBackup is the Schema for the databaseclusterbackups API.
  - `apiVersion` string — APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  - `kind` string — Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
  - `metadata` object
  - `spec` object — DatabaseClusterBackupSpec defines the desired state of DatabaseClusterBackup.
    - `backupStorageName` string, required — BackupStorageName is the name of the BackupStorage used for backups. The BackupStorage must be created in the same namespace as the DatabaseCluster.
    - `dbClusterName` string, required — DBClusterName is the original database cluster name.
  - `status` object — DatabaseClusterBackupStatus defines the observed state of DatabaseClusterBackup.
    - `completed` string, date-time — Completed is the time when the job was completed.
    - `created` string, date-time — Created is the timestamp of the upstream backup's creation.
    - `destination` string — Destination is the full path to the backup.
    - `gaps` boolean, required — Gaps identifies if there are gaps detected in the PITR logs
    - `inUse` boolean — InUse is a flag that indicates if this restore resource is being used to restore DB cluster from backup.
    - `latestRestorableTime` string, date-time — LatestRestorableTime is the latest time that can be used for PITR restore
    - `state` string — State is the DatabaseBackup state.
    - `size` string — Size is the size of the backup

## Response `200`

Successful operation

- DatabaseClusterBackup — DatabaseClusterBackup is the Schema for the databaseclusterbackups API.
  - `apiVersion` string — APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
  - `kind` string — Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
  - `metadata` object
  - `spec` object — DatabaseClusterBackupSpec defines the desired state of DatabaseClusterBackup.
    - `backupStorageName` string, required — BackupStorageName is the name of the BackupStorage used for backups. The BackupStorage must be created in the same namespace as the DatabaseCluster.
    - `dbClusterName` string, required — DBClusterName is the original database cluster name.
  - `status` object — DatabaseClusterBackupStatus defines the observed state of DatabaseClusterBackup.
    - `completed` string, date-time — Completed is the time when the job was completed.
    - `created` string, date-time — Created is the timestamp of the upstream backup's creation.
    - `destination` string — Destination is the full path to the backup.
    - `gaps` boolean, required — Gaps identifies if there are gaps detected in the PITR logs
    - `inUse` boolean — InUse is a flag that indicates if this restore resource is being used to restore DB cluster from backup.
    - `latestRestorableTime` string, date-time — LatestRestorableTime is the latest time that can be used for PITR restore
    - `state` string — State is the DatabaseBackup state.
    - `size` string — Size is the size of the backup

## Other responses

- `201` — Created success
- `202` — Accepted
- `400` — Unsuccessful operation
- `500` — Internal server error

## Changes

- **2026-04-27** `998696c35b1e` — 4 info
  - added the new optional request property `status/size`
  - added the optional property `status/size` to the response with the `200` status
  - added the optional property `status/size` to the response with the `201` status
  - added the optional property `status/size` to the response with the `202` status
- **2025-12-22** `7da8818e8d9b` — 4 info
  - added the new optional request property `status/inUse`
  - added the optional property `status/inUse` to the response with the `200` status
  - added the optional property `status/inUse` to the response with the `201` status
  - added the optional property `status/inUse` to the response with the `202` status
- **2024-09-16** `93990296b4fd` — 4 info
  - added the new optional request property `status/latestRestorableTime`
  - added the optional property `status/latestRestorableTime` to the response with the `200` status
  - added the optional property `status/latestRestorableTime` to the response with the `201` status
  - added the optional property `status/latestRestorableTime` to the response with the `202` status
- **2024-06-19** `00f3dd8cb624` — 2 info
  - api tag `Backup` added
  - api tag `databaseClusterBackup` removed
- …earlier changes not shown

[Full history](https://skmtc.dev/openeverest/apis/openeverest-schema/changes/namespaces/:namespace/database-cluster-backups/post.md)

---

[API](https://skmtc.dev/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.dev/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openeverest/openeverest-schema/revisions/46b19e13670b/schema)