Engine Version No Longer Supported

backup-engine-version-unsupported · 422

The backup was taken from a version of its engine that Ghaym Cloud no longer offers, so the API started no restore.

A restore makes a new database on the backup's own version, so that version must still be offered. PostgreSQL offers 16, 17 and 18, MySQL offers 8.4, and engineVersion is the backup's.

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

Common causes

  • The database ran a version that has since been retired, and this backup is from then.

How to fix the call

  • Pick a backup taken on a version that is still offered, if there is one.
  • Tell the user, quoting engineVersion: this backup can't be restored here.
  • Don't retry: a retired version doesn't come back.

Example response

json
{
  "type": "backup-engine-version-unsupported",
  "title": "Engine Version No Longer Supported",
  "detail": "This backup was taken from PostgreSQL 15, which is no longer offered, so it cannot be restored.",
  "engineVersion": "15",
  "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": 422,
  "docs": "https://ghaym.me/docs/errors/backup-engine-version-unsupported"
}