Backup Not Restorable

backup-not-restorable · 409

Only a backup whose status is ready can be restored, and this one isn't, so the API started no restore.

A backup is pending or running while it is taken, then ready or failed. backupId names the backup that was refused.

Besides the members every error carries, this type adds backupId.

Common causes

  • The backup is still being taken.
  • The backup failed, so there is nothing to restore from it.

How to fix the call

  • Wait for a pending or running backup to become ready, then restore it.
  • Or pick another backup whose status is ready.
  • Don't retry a failed backup: it never becomes ready.

Example response

json
{
  "type": "backup-not-restorable",
  "title": "Backup Not Restorable",
  "detail": "This backup is not ready, so it cannot be restored.",
  "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/restore",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/backup-not-restorable"
}