API: Instanz löschen

Endpunkt

DELETE /api/v1/instances/:id

Löscht eine Instanz und die zugehörige VPS dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.

Authentifizierung

Füge deinen API-Schlüssel im Authorization-Header hinzu:

Authorization: Bearer oc_live_dein_api_schlüssel

Siehe API-Übersicht für Details zum Erstellen und Verwalten von API-Schlüsseln.

Anfrage

Ersetze :id durch die numerische Instanz-ID. Kein Request-Body erforderlich.

Beispiel:

curl -X DELETE https://clawhosters.com/api/v1/instances/42 \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel"

Antwort

Erfolg (200 OK)

Der Server wird zur Löschung vorgemerkt. Der Instanz-Status wechselt zu deleting.

{
  "data": {
    "id": 42,
    "name": "my-ai-bot",
    "status": "deleting",
    "tier": "balanced",
    "billing_mode": "daily",
    "ip_address": null,
    "health_status": "unknown",
    "created_at": "2026-02-05T12:34:56Z",
    "provisioned_at": "2026-02-05T12:40:22Z",
    "can_start": false,
    "can_stop": false,
    "can_restart": false,
    "subdomain_url": "my-ai-bot.clawhosters.com",
    "daily_claw_cost": 225,
    "llm_configured": true,
    "telegram_configured": true
  }
}

Was bei der Löschung passiert

1. Der Instanz-Status wird auf deleting gesetzt
2. Die Hetzner-VPS wird im Hintergrund zerstört
3. Die tägliche Abrechnung stoppt für die Instanz
4. Zugehörige Snapshots werden bereinigt
5. Der Instanz-Eintrag wird aus deinem Account entfernt

Fehlerantworten

Nicht gefunden (404)

Die Instanz existiert nicht oder gehört einem anderen Kunden.

{
  "error": {
    "code": "not_found",
    "message": "Instance not found"
  }
}

Nicht verarbeitbar (422)

Wird zurückgegeben, wenn die Instanz in ihrem aktuellen Zustand nicht gelöscht werden kann (z. B. bereits beim Löschen).

{
  "error": {
    "code": "unprocessable_entity",
    "message": "Instance cannot be deleted in its current state"
  }
}

Nicht autorisiert (401)

Wird zurückgegeben, wenn der API-Schlüssel fehlt, ungültig oder widerrufen ist.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

Hinweise

• Die Löschung ist endgültig. Alle Daten auf der VPS gehen verloren. Wenn du ein Backup-Add-on hast, bleiben vorhandene Backups gemäß ihrer Aufbewahrungsrichtlinie erhalten.
• Die Instanz erscheint weiterhin in der Listenansicht mit dem Status deleting, bis der Hintergrund-Job abgeschlossen ist.
• Die tägliche Abrechnung stoppt in dem Moment, in dem die Löschanfrage akzeptiert wird.
• Wenn du eine Instanz vorübergehend stoppen möchtest, ohne Daten zu verlieren, verwende stattdessen die Stop-Aktion.

Verwandte Dokumentation

• API-Übersicht — Authentifizierung, Rate-Limits und Antwortformat
• Instanz-Details abrufen — Instanz-Details vor dem Löschen anzeigen
• Instanzen auflisten — Alle deine Instanzen auflisten