Prepare backup download
POST/backups/:backup_id/exports
Prepares a ZIP64 archive with raw disks and configuration. No separate export fee. Maximum one accepted export per copy in a rolling 24-hour window, including pending/failed attempts. Same-key retries do not consume another slot. Use the order worker_operation_id to read export status and obtain a link. The prepared archive is retained for 24 hours after completion. Backup storage size (stored_size_bytes) and ZIP download size (export size_bytes) are different measurements. The export is built separately from the reconstructed disk image and compressed again, so its size may be larger or smaller. A size difference alone does not indicate a damaged backup.
Send Idempotency-Key. HTTP 202 returns order_id; poll GET /orders/{order_id}. Acceptance is not completion. worker_operation_id appears after dispatch. Free actions are also recorded as zero-amount orders.
Request
Responses
- 202
- 401
- 404
- 409
- 422
- 429
- 500
- 503
Successful Response
Missing or invalid key, mismatched ID, or inactive integration
Resource not found in this integration
Business or state conflict; inspect detail
Invalid request fields or unsupported parameters
Rolling 24-hour operation limit reached
Unexpected server error
Service unavailable or result unconfirmed; for a mutation retain its idempotency key