---
title: "Restore cloud backup / Create new site from backup"
method: POST
path: "/v1/sites/{id}/cloud_backups/{backup_id}/restore"
tags: ["Backups"]
---

# Restore cloud backup / Create new site from backup

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

Restore a cloud backup to an existing site or create a new site from the backup - Via A Task

## Path parameters

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

## Request body

- RestoreCloudBackupRequest
  - `includes_files` boolean, required — Whether to restore the files from the backup
  - `includes_database` boolean, required — Whether to restore the database from the backup
  - `restore_paths` string[] — If specified, only the files in these paths will be restored (requires includes_files to be true). Paths are relative to /home/$user

## Response `200`

OK

- TaskIDResponse — Information about the task that was created as a result of this API call
  - `success` boolean — whether the request succeeded
  - `errors` string[]
  - `messages` string[], nullable
  - `result` object
    - `task_id` string — Task ID of the task that is now running
    - `task_level` 'account' | 'site' — Level at which the task exists

## 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.dev/rocket/apis/rocket-net-api.md) · [All operations](https://skmtc.dev/rocket/apis/rocket-net-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rocket/rocket-net-api/revisions/db0dcbbc5764/schema)