Backup In Use

backup-held-by-restore · 409

A restore is reading this backup right now, so the API didn't delete it.

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.

Common causes

  • The backup was deleted while a restore from it was still running.

How to fix the call

  • 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.

Example response

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"
}