OpenAPI JSON

Create and monitor a backup

Backups are represented as snapshots. The API exposes backup activation and snapshot history; longer-running actions such as downloads, restores, and migrations return tasks.

1. Enable backups

Call Enable site backups for the site. No request body is required.

curl --request POST \
  --url https://api.blogvault.net/api/v6/sites/SITE_ID/backups/enable \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Accept: application/json'

The response confirms the site’s backup state. The site plan must support Backups.

2. Find a completed snapshot

Use List site snapshots and select a snapshot whose status is succeeded:

curl --get \
  --url 'https://api.blogvault.net/api/v6/sites/SITE_ID/snapshots?sort=created_at,desc' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Accept: application/json'

The snapshot ID is the input for download, restore, upload, and migration operations. The list defaults to the last seven days; use the documented created_at filters for older history.

3. Monitor related work

When you start a backup download, restore, or migration, save the returned task ID and follow the asynchronous jobs guide.

Common failure cases

  • The site does not support Backups or backups are not enabled.
  • The snapshot is not complete yet; choose a succeeded snapshot.
  • The snapshot is not available to the authenticated account.
  • The request exceeds rate limits while polling.