hosting
POST /v1/sites/{siteId}/wordpress/smart-updates
Update plugins and themes on a staging copy first, then live only if nothing broke.
Authentication
Send an API key as a bearer token. The key must carry the sites.panel_access 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}/wordpress/smart-updates \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'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
Queues a smart update (owner #1, docs/1135 §8): a fresh staging copy, a lab screenshot, the updates applied to the copy, a second screenshot, a health check (WordPress loads with its plugins; the copy answers without a 5xx) and a pixel comparison. Live is updated only when the copy is clean and less than hold_at_permille of the page changed; otherwise the run is held and live is untouched. The copy is removed on every path. Omit plugins/themes to take everything with an update available. Refused 422 when the plan has no staging, the account is not in good standing, the site already has a staging copy (it would be overwritten) or there is nothing to update; 409 while a run is in flight; 503 when the queue is unreachable. Requires sites.panel_access.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
plugins | string[] | No | Plugin slugs to update; omitted = every plugin with an update. |
themes | string[] | No | Theme slugs to update; omitted = every theme with an update. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
data | SiteSmartUpdateRun[] | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 409 · 422 · 429 · 503