Create this site's staging copy
Permission: site.staging
apiTokenAuthorizationBearer <token>An API token (mwp_…) from Settings → API tokens. Only accepted on this host.
site_id*Site IduuidIdempotency-Key?stringAny unique string up to 255 characters. Retrying with the same key returns the first request's stored response (header Idempotent-Replayed: true) instead of doing it again, for 24 hours. The same key with a different request is refused (idempotency_key_reused).
1 <= length <= 255application/json- body
Body for POST /sites/{site_id}/staging.
Deliberately smaller than SiteClone. The label is derived from the parent (a staging site the customer has to name is a site), the PHP version is the parent's because a copy on a different version tests something they are not running, and the region is the parent's because staging is pinned to the parent's server.
domain?DomainBase domain for the staging subdomain
"magicwp.net"storage_limit?|Storage limit in GB. Defaults to the parent site's.
Successful Response
application/json- response
success*booleandata*The site (new, or the one being overwritten by a push) and the task working on it; poll the task until it finishes.
message*stringstatus_code*integertimestamp*stringdate-timemeta?|nullcurl -X POST "https://example.com/v1/sites/497f6eca-6276-4993-bfeb-53cbbbba6f08/staging" \ -H "Content-Type: application/json" \ -d '{}'{ "message": "string", "status_code": 0, "timestamp": "2019-08-24T14:15:22Z", "meta": {}, "success": true, "data": { "site": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "stack_number": 0, "server_id": "820efca4-4a15-4ab7-82fc-9e76f6d61325", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627", "domain_name": "string", "custom_domain": "string", "site_label": "string", "region": "string", "status": "string", "message": "string", "site_type": "string", "template_id": null, "template_version": null, "wp_version": "string", "wp_installed": true, "php_hardened": null, "config_profile": null, "php_version": "string", "storage_limit": 0, "storage_usage": 0, "maintenance_mode": true, "notes": null, "notes_updated_at": null, "notes_updated_by": null, "parent_site_id": null, "expires_at": null, "extend_count": 0, "demo_expires_at": null, "demo_stopped_at": null, "demo_converted_at": null, "site_lock": true, "lock_reason": "string", "locked_at": "2019-08-24T14:15:22Z", "billing_suspended_at": "2019-08-24T14:15:22Z", "admin_suspended_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z" }, "task": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "task_type": "string", "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811", "status": "string", "result": "string", "error_message": "string", "metadata_json": {}, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z" } }}