---
title: "Changes to Create a backup"
method: POST
path: "/organizations/{organization}/databases/{database}/branches/{branch}/backups"
---

# Changes to Create a backup

`POST /organizations/{organization}/databases/{database}/branches/{branch}/backups`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 24 revisions.

- **2026-07-08** `fa19f3305241` — 1 info
- **2026-06-01** `72506953f367` — 18 breaking, 1 info
- **2025-12-09** `d710019068fb` — 1 breaking
- **2025-12-04** `5e881928d77a` — 2 breaking, 11 info

## Changes

- **2026-07-08** `fa19f3305241` — 1 info
  - added the required property `uncompressed_size` to the response with the `201` status
- **2026-06-01** `72506953f367` — 18 breaking, 1 info
  - the response property `actor` became nullable for the status `201`
  - the response property `backup_policy` became nullable for the status `201`
  - the response property `backup_policy/last_ran_at` became nullable for the status `201`
  - the response property `backup_policy/next_run_at` became nullable for the status `201`
  - the response property `backup_policy/schedule_day` became nullable for the status `201`
  - the response property `backup_policy/schedule_week` became nullable for the status `201`
  - the response property `completed_at` became nullable for the status `201`
  - the response property `database_branch` became nullable for the status `201`
  - the response property `database_branch/deleted_at` became nullable for the status `201`
  - the response property `deleted_at` became nullable for the status `201`
  - the response property `expires_at` became nullable for the status `201`
  - the response property `restored_branches/items/deleted_at` became nullable for the status `201`
  - the response property `schema_snapshot` became nullable for the status `201`
  - the response property `schema_snapshot/linted_at` became nullable for the status `201`
  - the response property `started_at` became nullable for the status `201`
  - the response property `backup_policy` became optional for the status `201`
  - the response property `database_branch` became optional for the status `201`
  - the response property `schema_snapshot` became optional for the status `201`
  - added the required property `backup_policy/display_name` to the response with the `201` status
- **2025-12-09** `d710019068fb` — 1 breaking
  - the `retention_value` request property type/format changed from `number`/`` to `integer`/``
- **2025-12-04** `5e881928d77a` — 2 breaking, 11 info
  - the `backup_policy/schedule_day` response's property type/format changed from `string`/`` to `number`/`` for status `201`
  - the `backup_policy/schedule_week` response's property type/format changed from `string`/`` to `number`/`` for status `201`
  - removed the `0.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `0.00` enum value from the `backup_policy/schedule_week` response property for the response status `201`
  - removed the `1.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `1.00` enum value from the `backup_policy/schedule_week` response property for the response status `201`
  - removed the `2.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `2.00` enum value from the `backup_policy/schedule_week` response property for the response status `201`
  - removed the `3.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `3.00` enum value from the `backup_policy/schedule_week` response property for the response status `201`
  - removed the `4.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `5.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`
  - removed the `6.00` enum value from the `backup_policy/schedule_day` response property for the response status `201`

---

[Operation](https://skmtc.dev/planetscale/apis/planetscale-api/docs/organizations/:organization/databases/:database/branches/:branch/backups/post.md) · [API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [Page](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/databases/:database/branches/:branch/backups/post)