Restore a backup to a new volume

POST/volumes/{name}/restore

Materialises a backup into the new volume {name}. 409 when {name} already exists (restore never overwrites), 404 when the backup is gone.

path parameters

object

namestringrequired

Name of the new volume to create.

Request bodyapplication/json

RestoreVolReq

fromstring

Backup id to restore.

Responses

201 CreatedCreated

Volume

attached_tostring

created_atstringdate-time

host_idstring

namestring

size_bytesintegerint64

400 Bad requestBad Request

ErrorResponse

errorstring

404 Not foundNot Found

ErrorResponse

errorstring

409 ConflictConflict

ErrorResponse

errorstring

501 Not Implemented

ErrorResponse

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍POST/volumes/{name}/restore

cURL

curl '/volumes/{name}/restore' \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{}'

JavaScript

const response = await fetch("/volumes/{name}/restore", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: "{}",
});
const data = await response.json();

Python

import requests

response = requests.post(
    "/volumes/{name}/restore",
    headers={
    "Content-Type": "application/json",
},
    data="{}",
)
data = response.json()

Response

201 Created

{
  "attached_to": "string",
  "created_at": "2026-01-02T15:04:05Z",
  "host_id": "string",
  "name": "string",
  "size_bytes": 0
}