Backup In Use
backup-held-by-restore · 409
A restore is reading this backup right now, so the API didn't delete it.
All pages
The backup can be deleted once the restore is no longer pending, provisioning or restoring. Nothing was changed.
Besides the members every error carries, this type adds backupId.
- The backup was deleted while a restore from it was still running.
- Follow the restore with
GET /v1/services/<id>/restores/<restoreId>until it ends, then delete the backup. - Don't retry in a tight loop: a restore can take minutes.
json
{
"type": "backup-held-by-restore",
"title": "Backup In Use",
"detail": "A restore is reading this backup. Wait for it to finish, then delete it.",
"backupId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
"requestId": "req-1785231000000-4f7b2c9ae",
"timestamp": "2026-07-28T09:30:00.000Z",
"path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
"method": "DELETE",
"instance": "DELETE /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
"status": 409,
"docs": "https://ghaym.me/docs/errors/backup-held-by-restore"
}