Backup Already Running

backup-in-flight · 409

A backup of this database is already pending or running, so the API didn't start a second one.

One backup runs at a time for each database in each environment, nightly or by hand. environmentId names the environment.

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

Common causes

  • The nightly backup was running when a backup by hand was asked for.
  • A backup by hand was asked for twice, such as on a double click or a retry after a timeout.

How to fix the call

  • Read the database's backups and wait until the running one is ready or failed.
  • The running backup may be the one the user wanted: check its time before taking another.
  • Don't retry in a tight loop: a backup can take minutes.

Example response

json
{
  "type": "backup-in-flight",
  "title": "Backup Already Running",
  "detail": "A backup of this database is already running. Wait for it to finish.",
  "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "environmentId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403",
  "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": 409,
  "docs": "https://ghaym.me/docs/errors/backup-in-flight"
}