hosting

POST /v1/sites/{siteId}/wordpress/smart-updates

Update plugins and themes on a staging copy first, then live only if nothing broke.

All hosting endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

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

NameTypeRequiredWhat it is
siteId (path)UuidYesSite ID (UUIDv7).

Request body

NameTypeRequiredWhat it is
pluginsstring[]NoPlugin slugs to update; omitted = every plugin with an update.
themesstring[]NoTheme slugs to update; omitted = every theme with an update.

Response

NameTypeRequiredWhat it is
dataSiteSmartUpdateRun[]Yes—

Errors this endpoint can return

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