API-Dokumentation

Sicherungen auflisten

Gibt alle vorhandenen Sicherungen eines VPS zurück.

Anfrage

GET /api/v1/vps/{id}/backups

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "backupId": "backup_abc123",
      "os": "Ubuntu 22.04",
      "description": "Tägliche Sicherung",
      "label": "Vor Update",
      "size": 5368709120,
      "created": "2026-03-27T02:00:00Z",
      "status": "finished"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
backupId string Eindeutige Sicherungs-ID
os string Betriebssystem zum Zeitpunkt der Sicherung
description string Beschreibung der Sicherung
label string | null Benutzerdefinierte Bezeichnung, oder null wenn nicht gesetzt
size integer Größe der Sicherung in Bytes
created string ISO-8601-Erstellungszeitstempel
status string finished oder pending

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Daten sind auch über das list_backups MCP-Tool verfügbar.