Retry failed backups

POST

https://api.modulards.com/api/public/v1/site-backups/retry

POST

/api/public/v1/site-backups/retry

curl -X POST https://api.modulards.com/api/public/v1/site-backups/retry \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "backups": [
    9001,
    9002
  ]
}'

202Retry failed backups

{
  "data": [
    {
      "attributes": {
        "attempts": 1,
        "backup_type": "full",
        "comment": null,
        "created_at": "2026-09-14T15:00:00.000000Z",
        "is_favorite": false,
        "method": "manual",
        "phase": "failed",
        "restored_at": null,
        "site_id": 12,
        "size": 0,
        "status": "failed",
        "updated_at": "2026-09-14T16:05:00.000000Z"
      },
      "id": "9001",
      "links": {
        "self": "{{base_url}}/api/public/v1/site-backups/9001"
      },
      "type": "site-backups"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "meta": {
    "skipped": [
      {
        "backup_id": 9002,
        "message": "Only a failed backup can be retried.",
        "reason_code": "UNSUPPORTED",
        "site_id": 12,
        "site_name": "Shop"
      }
    ]
  }
}

Queues failed backups again. The server already retries a failed backup on its own, up to 3 times, within 24 hours of its creation, so a manual retry is rarely needed within that time.

Follow the retried backups with “List backups” (filter[id][]) and read phase. The work finishes later: see Writes and asynchronous operations. Backups that cannot be retried are reported in meta.skipped, each with a reason_code and a message, and do not fail the call: UNSUPPORTED (the backup is not in phase failed), SITE_UNREACHABLE (website not connected), CONFLICT (another backup or a restoration is running on that website) and PERMISSION_DENIED (a backup your token cannot reach).

Body

backups (array of integers, required): ids of the backups to retry, 1 to 50, from “List backups” with filter[phase][]=failed.

Errors

409: the storage quota is exhausted and no overage add-on is active. Nothing is retried.
422: backups is missing, empty, has more than 50 ids or contains an id that is not a backup.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Request

This endpoint expects an object.

backupslist of doublesOptional

Response

202 Accepted - one copy re-queued, one skipped

datalist of objectsOptional

jsonapiobjectOptional

metaobjectOptional