Back up a volume

POST/volumes/{name}/backups

Takes a consistent point-in-time backup of the volume, restorable to a new volume. 409 when the volume is attached to a running sandbox (sleep it first).

path parameters

object

namestringrequired

Volume name ([a-z0-9][a-z0-9-]*).

Responses

201 CreatedCreated

Backup

consistencystring

created_atstringdate-time

host_idstring

idstring

size_bytesintegerint64

source_volumestring

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}/backups

cURL

curl '/volumes/{name}/backups' \
  -X POST

JavaScript

const response = await fetch("/volumes/{name}/backups", {
  method: "POST",
});
const data = await response.json();

Python

import requests

response = requests.post(
    "/volumes/{name}/backups",
)
data = response.json()

Response

201 Created

{
  "consistency": "string",
  "created_at": "2026-01-02T15:04:05Z",
  "host_id": "string",
  "id": "string",
  "size_bytes": 0,
  "source_volume": "string"
}