POST /v1/sites/{siteId}/clone

身份验证

请将 API 密钥作为 bearer 令牌发送。此端点在规范中未指明具体的权限，因此请为您的密钥赋予所需的最小权限，并通过检查响应来确认，而不是盲目假设。

此端点不需要组织 ID。您的密钥已用于识别其所属的组织，且响应范围也仅限于该组织。

免费试用

将尖括号中的内容替换为您自己的值，并将键占位符替换为您仪表板中的一个键。

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> }'

已登录？您仪表板中的 API 控制台会自动填入您真实的组织 ID 和您自己的密钥，并针对实时 API 运行请求，以便您查看实际的响应。 在 API 控制台中打开此端点

详细信息

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.

参数

请求正文

响应

此端点可能返回的错误

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