hosting
POST /v1/sites/{siteId}/clones/{cloneId}/retry
Finish a copy that failed, onto the same new site.
Authentication
Send an API key as a bearer token. The key must carry the hosting.backup.manage permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/clones/{cloneId}/retry \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Recovery goes to the step that failed: when the copy of this site was never made a new one is taken, and when it was it is reused. Either way it is restored onto the SAME new site, so a half-built site never has to be deleted to try again. 409 when the copy has not failed; 422 when its new site has been deleted. Requires hosting.backup.manage, because it overwrites the new site's content.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
cloneId (path) | Uuid | Yes | The id of a row from listSiteClones. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
blueprint_id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
site_id | Uuid | Yes | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
site_name | string | Yes | — |
site_domain | string | Yes | — |
site_status | string | Yes | The new site's status, or deleted when it no longer exists. |
step | SiteCloneStep | Yes | copying — the copy of the original is being taken; waiting — the new site is still being built; restoring — the copy is being put onto it; done; failed. |
message | string | Yes | Why it failed, or what still needs attention. English; shown verbatim. |
can_retry | boolean | Yes | Whether retrySiteClone will accept this row. |
created_at | string | Yes | — |
finished_at | object | No | — |
Errors this endpoint can return
401 · 403 · 404 · 409 · 422 · 429 · 503