---
title: "Changes to Create a new snapshot of a database"
method: POST
path: "/v2/databases/{databaseId}/snapshots"
---

# Changes to Create a new snapshot of a database

`POST /v2/databases/{databaseId}/snapshots`

> Every recorded change to this operation, newest first.
> 18 revisions in range; 1 not diffed.

## Timeline

Changed in 8 of 18 revisions.

- **2026-11-13** `e363e004303c`: 6 warning
- **2026-11-02** `4cf53a0d5577`: 12 warning
- **2026-10-22** `9a304694ce5c`: 6 info
- **2026-10-21** `9d1a68b388c3`: 20 warning, 1 info
- **2026-10-04** `9cea915c6aca`: 10 warning
- **2026-10-02** `6ddd9ee0d523`: 10 warning
- **2026-09-28** `2e2aab744d77`: 6 warning, 8 info
- **2026-09-28** `4a9cd977f76a`: 5 breaking, 1 warning, 9 info

## Changes

- **2026-11-13** `e363e004303c`: 6 warning
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `409`
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `SNAPSHOTS_UNAVAILABLE` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
- **2026-11-02** `4cf53a0d5577`: 12 warning
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `409`
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `WRITE_FAILED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `409`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `WRONG_HOST` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
- **2026-10-22** `9a304694ce5c`: 6 info
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `409`
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - removed the `METRICS_NOT_SUPPORTED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
- **2026-10-21** `9d1a68b388c3`: 20 warning, 1 info
  - added the new `RESTORE_INTERRUPTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `RESTORE_INTERRUPTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `RESTORE_INTERRUPTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `RESTORE_INTERRUPTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `RESTORE_INTERRUPTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `SNAPSHOT_CORRUPT` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `SNAPSHOT_CORRUPT` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `SNAPSHOT_CORRUPT` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `SNAPSHOT_CORRUPT` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `SNAPSHOT_CORRUPT` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `SNAPSHOT_IN_PROGRESS` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `SNAPSHOT_IN_PROGRESS` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `SNAPSHOT_IN_PROGRESS` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `SNAPSHOT_IN_PROGRESS` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `SNAPSHOT_IN_PROGRESS` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `SNAPSHOT_RESTORE_PROCESSING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `SNAPSHOT_RESTORE_PROCESSING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `SNAPSHOT_RESTORE_PROCESSING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `SNAPSHOT_RESTORE_PROCESSING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `SNAPSHOT_RESTORE_PROCESSING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the non-success response with the status `409`
- **2026-10-04** `9cea915c6aca`: 10 warning
  - added the new `GIT_BRANCH_DELETED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `GIT_BRANCH_DELETED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `GIT_BRANCH_DELETED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `GIT_BRANCH_DELETED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `GIT_BRANCH_DELETED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `GIT_REF_NOT_SUPPORTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `GIT_REF_NOT_SUPPORTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `GIT_REF_NOT_SUPPORTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `GIT_REF_NOT_SUPPORTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `GIT_REF_NOT_SUPPORTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
- **2026-10-02** `6ddd9ee0d523`: 10 warning
  - added the new `AI_WEEKLY_LIMIT_REACHED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `AI_WEEKLY_LIMIT_REACHED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `AI_WEEKLY_LIMIT_REACHED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `AI_WEEKLY_LIMIT_REACHED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `AI_WEEKLY_LIMIT_REACHED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
  - added the new `ENV_BUSY` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `ENV_BUSY` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - added the new `ENV_BUSY` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `ENV_BUSY` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `ENV_BUSY` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `503`
- **2026-09-28** `2e2aab744d77`: 6 warning, 8 info
  - added the new `GITHUB_NOT_CONNECTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `GITHUB_NOT_CONNECTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `GITHUB_NOT_CONNECTED` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the new `INVALID_ENCODING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `INVALID_ENCODING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `INVALID_ENCODING` enum value to the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - added the non-success response with the status `403`
  - added the non-success response with the status `503`
  - removed the `APIKEY_EXPIRED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - removed the `APIKEY_EXPIRED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - removed the `APIKEY_EXPIRED` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
  - removed the `USER_NOT_FOUND` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - removed the `USER_NOT_FOUND` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - removed the `USER_NOT_FOUND` enum value from the `code/anyOf[#/components/schemas/ErrorCode]/` response property for the response status `500`
- **2026-09-28** `4a9cd977f76a`: 5 breaking, 1 warning, 9 info
  - the response property `response/key` became optional for the status `200`
  - the response property `response/url` became optional for the status `200`
  - the `code` response's property type changed from `string` to no type for status `401`
  - the `code` response's property type changed from `string` to no type for status `404`
  - the `code` response's property type changed from `string` to no type for status `500`
  - removed the optional property `message` from the response with the `202` status
  - added `#/components/schemas/ErrorCode, subschema #2` to the `code` response property `anyOf` list for the response status `401`
  - added `#/components/schemas/ErrorCode, subschema #2` to the `code` response property `anyOf` list for the response status `404`
  - added `#/components/schemas/ErrorCode, subschema #2` to the `code` response property `anyOf` list for the response status `500`
  - the response property `code` became required for the status `202`
  - the `code` response property const value `SNAPSHOT_PROCESSING` was added for the status `202`
  - the `code` response's property pattern `^[A-Z][A-Z0-9_]+$` was removed for the status `202`
  - the `code` response's property pattern `^[A-Z][A-Z0-9_]+$` was removed for the status `401`
  - the `code` response's property pattern `^[A-Z][A-Z0-9_]+$` was removed for the status `404`
  - the `code` response's property pattern `^[A-Z][A-Z0-9_]+$` was removed for the status `500`

---

[Operation](https://skmtc.dev/squarecloud/apis/square-cloud-api/docs/v2/databases/:databaseId/snapshots/post.md) - [API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) - [Page](https://skmtc.dev/squarecloud/apis/square-cloud-api/changes/v2/databases/:databaseId/snapshots/post)
