VPS

Create manual backup

post/vps/{vps_id}/backups

Create an immediate backup of your server. Manual backups are useful before major changes or maintenance.

Autorización

Authorization

Authorization*string

Bearer YOUR_API_TOKEN con un token de API. También vale la cabecera X-API-Key: YOUR_API_TOKEN.

Parámetros de ruta

vps_id*integer

Rango1 ≤ value

Cuerpo de la petición

Create manual backup

application/jsonObligatorio

notes?string | null

Optional notes for the backup

Rangolength ≤ 500

Respuestas

Successful Response

application/json

id*integer

vps_id*integer

backup_type*BackupType

Valores"manual""automatic"

backup_volid*string | null

status*BackupStatus

Valores"pending""in_progress""completed""failed""deleted"

progress*integer

Rango0 ≤ value ≤ 100

size_gb*number | null

pbs_storage*string | null

started_at*string | null

Formatodate-time

completed_at*string | null

Formatodate-time

error_message*string | null

notes*string | null

created_at*string

Formatodate-time

snapshot_uuid?string | null

Ejemplo de petición

POST/vps/{vps_id}/backups

curl -X POST "https://api.cubepath.com/vps/1/backups" \
  -H "Authorization: Bearer $CUBEPATH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "notes": "Pre-upgrade backup"
}'

Ejemplo de respuesta

{
  "id": 1,
  "vps_id": 1,
  "backup_type": "manual",
  "backup_volid": "string",
  "status": "pending",
  "progress": 1,
  "size_gb": 0,
  "pbs_storage": "string",
  "started_at": "2026-01-01T00:00:00Z",
  "completed_at": "2026-01-01T00:00:00Z",
  "error_message": "string",
  "notes": "string",
  "created_at": "2026-01-01T00:00:00Z",
  "snapshot_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}