OpenAPI JSON

Create a staging site

Staging sites are temporary WordPress copies created from a completed backup snapshot. The create request is asynchronous.

1. Choose the source

Use List site snapshots to find a completed snapshot, then keep its site_id and snapshot_id together. A staging site must be created from a snapshot of the source site.

2. Start staging creation

Call Create a staging site:

curl --request POST \
  --url https://api.blogvault.net/api/v6/staging-sites \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "staging_site": {
      "site_id": "SITE_ID",
      "snapshot_id": "SNAPSHOT_ID",
      "php_version": "8.2"
    }
  }'

The response returns a task ID. Follow the asynchronous jobs guide until the task completes.

3. Retrieve the result

After the task succeeds, List staging sites and use Show a staging site to retrieve access details, status, expiry, and the WordPress environment.

Lifecycle considerations

Staging sites can expire and may be paused or resumed. Present the expiry time to users and link the extend, resume, download, and delete operations from the staging-site detail view.