hosting
POST /v1/sites/{siteId}/clone
Copy this site onto a new domain, as a new site.
Uwierzytelnianie
Wyślij klucz API jako token bearer. Ten punkt końcowy nie określa konkretnego uprawnienia w specyfikacji, więc nadaj swojemu kluczowi minimum potrzebnych uprawnień i sprawdź odpowiedź zamiast zakładać.
Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.
Wypróbuj
Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/clone \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "primary_domain": <string> }'Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API
Szczegóły
Creates a new site on the same plan, product line, stack and region as this one, takes a copy of this site's files and database, and restores that copy onto the new site once it has finished being built — then points the copy's stored web addresses (a WordPress database names its own URLs) at the new domain. This site is only read, never changed. ⭐ A clone is a site blueprint capture and a blueprint deploy in one call, so it is durable end to end and every guard those enforce applies here. The copy is kept as a blueprint named after both domains, and progress is read from GET /v1/sites/{siteId}/clones. The copy's backup does not spend the on-demand backup allowance: a clone is paid for with a site slot, which is checked exactly as POST /v1/sites checks it. A refusal from that check (no slot left, the domain taken) creates nothing. Refusals carry a machine code in error.details[0].code: site_not_active and clone_not_supported (422), backup_in_flight (409). ⛔ "As staging" is a different product — a private copy on the SAME site that publishes back — and lives at /v1/sites/{siteId}/wordpress/staging. Requires both sites.create and sites.blueprint.manage: it spends a site slot and it reads this site's whole content into a copy.
Parametry
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
siteId (path) | Uuid | Tak | Site ID (UUIDv7). |
Treść żądania
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
primary_domain | string | Tak | The new site's domain. It must not be in use by any site. |
name | string | Nie | A name for the new site in your site list. Defaults to the domain. |
Odpowiedź
| Nazwa | Typ | Wymagane | Co to jest |
|---|---|---|---|
site | Site | Tak | — |
clone | SiteClone | Tak | — |
Błędy, które ten punkt końcowy może zwrócić
401 · 403 · 404 · 409 · 422 · 429 · 503