---
title: "Create a new cloud backup"
method: POST
path: "/v1/sites/{id}/cloud_backups"
tags: ["Backups"]
---

# Create a new cloud backup

`POST /v1/sites/{id}/cloud_backups`

Create a new cloud backup of the users' files and/or database for a given site (staging sites will only backup the staging webroot) - Via A Task

## Path parameters

- `id` integer, required — ID of the Site you are interacting with

## Request body

- CreateCloudBackupRequest
  - `label` string, required — Label / Name of the backup
  - `includes_files` boolean — If the backup should include all files from the site
  - `includes_database` boolean — If the backup should include the database
  - `exclude_paths` string[] — Paths to exclude from the backup

## Response `200`

OK

- CreateCloudBackupResponse
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `result` object
    - `backup_id` string — ID of the backup that was created
    - `task_id` string — ID of the task that was used to create this backup
    - `task_level` string — Level of the task that was used to create this backup

## Other responses

- `400` — Bad Request
- `401` — Authentication failed
- `403` — Not authorized to access endpoint
- `404` — Given backup not found for user
- `405` — Invalid input
- `500` — Internal error

---

[API](https://skmtc.net/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.net/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/revisions/db0dcbbc5764/schema)