Skip to content

Delete a backup

DELETE/backups/runs/{id}/

manage Delete and money: deletes, credits, servers or panel settings. Scopes

Deletes every stored copy. Refused (409) while the backup is still running; 502 when a copy could not be deleted. Panel operators only.

Path parameters

idstring (uuid)required
A UUID string identifying this Backup.

Response

204 No response body

Errors

401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
404 Nothing with this id, or nothing the account can see.
409 Not now: the answer says why.
429 Slow down: wait the seconds in the Retry-After header, then try again.
502 A copy could not be deleted.

What each error means

cURL

curl -X DELETE 'https://panel.example.com/backups/runs/1/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

response = requests.delete(
    "https://panel.example.com/backups/runs/1/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
)
response.raise_for_status()

JavaScript

const response = await fetch('https://panel.example.com/backups/runs/1/', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}`);