Backups Are Off

backups-disabled · 422

Backups are switched off for this database in this environment, so the API took no backup.

Each environment has its own switch. Switching backups off in one stops its nightly backup and refuses a backup by hand there too. The backups already taken stay, and can still be restored.

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

Common causes

  • Someone switched backups off for this database in this environment, in the console or with backupsEnabled: false.

How to fix the call

  • Ask the user before switching backups on: it is their setting, and the nightly backups start again with it.
  • To switch them on, send PATCH /v1/services/<id>?environmentId=<environment> with backupsEnabled: true, then take the backup; without environmentId, the call switches production's backups on.
  • Don't retry unchanged: the setting doesn't change on its own.

Example response

json
{
  "type": "backups-disabled",
  "title": "Backups Are Off",
  "detail": "Backups are switched off for this database. Turn them on first.",
  "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups",
  "status": 422,
  "docs": "https://ghaym.me/docs/errors/backups-disabled"
}