hosting

DELETE `/v1/sites/{siteId}/wordpress/staging/{cloneId}`

Delete a site's WordPress staging clone.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن sites.view؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/wordpress/staging/{cloneId} \
  -H "Authorization: Bearer zdk_live_…"

هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API

التفاصيل

Removes one staging copy. The live site is untouched — this path is declared after the literal publish and reinstall segments precisely so a request to one of those can never resolve here. 202 and the whole staging state, because the removal continues at the vendor. 404 for a site whose platform has no WordPress to manage, and for an id that is not on it. Requires sites.view and sites.panel_access.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`siteId (path)`	`Uuid`	نعم	Site ID (UUIDv7).
`cloneId (path)`	`string`	نعم	The clone id returned by `getSiteWordPressStaging`. The vendor's identifier, carried as a string.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`permitted`	`boolean`	نعم	Whether this site may use WordPress staging at all — on the resold range the package type's own flag, and on our own fleet the plan's `staging` entitlement.
`publish_modes`	`string<files, db, both>[]`	نعم	Which publish scopes this site's platform can actually perform, for `publishSiteWordPressStaging`. A client offers exactly these and no more. ⛔⛔…
`publishable`	`boolean`	نعم	Whether the plan also carries publish to live, which is a separate permission from creating a staging copy. ⛔ Not folded into `permitted`, because the catalogue sells the two…
`reinstallable`	`boolean`	نعم	Whether the plan carries reinstalling the platform software over the staging copy. A fifth question for the same reason as `publishable`: the catalogue sells it separately, so…
`idle_removal_days`	`integer`	نعم	After how many days with no change a staging copy is removed automatically, or `null` when nothing ever removes it. ⛔⛔…
`idle_notice_days`	`integer`	نعم	How many days' warning the customer is emailed before that removal, or `null` when `idle_removal_days` is `null`.
`operations`	`SiteWordPressStagingOperation[]`	نعم	The site's recent staging operations, newest first — the client's window onto work that runs after the request returns. ⛔⛔…
`data`	`SiteWordPressStagingClone[]`	نعم	The staging copies that exist.

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 403 · 404 · 409 · 422 · 429 · 503

DELETE /v1/sites/{siteId}/wordpress/staging/{cloneId}