partner

POST `/v1/partner/customers/{externalId}/sites/{siteId}/upgrade-to-php`

Upgrade your customer's static HTML site to PHP hosting, in place.

Authentication

Send an API key as a bearer token. The key must carry the partner.domains 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/partner/customers/{externalId}/sites/{siteId}/upgrade-to-php \
  -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

The partner door to upgradeSiteToPhp. A static HTML site becomes a PHP site IN PLACE, with no downtime (owner brief, queue Q111). On our servers every site's web server already runs PHP, so nothing is copied, re-placed or re-pointed: the site's stack becomes php, its PHP version the plan's default (or php_version, when the plan offers it) and the PHP tuning follows in the next maintenance pass. 422 with details[].code SITE_NOT_STATIC (already PHP, WordPress or another stack), SITE_NOT_ACTIVE (still setting up), STATIC_ON_EDGE_HOST (published to an edge host that cannot run PHP: move it onto our servers first) or PHP_VERSION_NOT_OFFERED. Audited as hosting.site.upgrade_to_php. A site outside the customer's organization, or an unknown customer, is 404. Requires partner.domains.

Parameters

Name	Type	Required	What it is
`externalId (path)`	`string`	Yes	YOUR id for that customer — whatever your own system calls them. It is what makes linking idempotent, and it is scoped to your partner programme: another partner's id is a `404`…
`siteId (path)`	`Uuid`	Yes	Site ID (UUIDv7).

Request body

Name	Type	Required	What it is
`php_version`	`string`	No	A PHP version the site's plan offers; omitted = the plan's default.

Response

Name	Type	Required	What it is
`site_id`	`string`	Yes	—
`stack_type`	`string`	Yes	—
`runtime`	`string`	Yes	—
`php_version`	`string`	Yes	—

Errors this endpoint can return

401 · 403 · 404 · 422

POST /v1/partner/customers/{externalId}/sites/{siteId}/upgrade-to-php