hosting
GET /v1/sites/{siteId}/wordpress/uploads/{uploadId}
Read a resumable upload — its progress and which parts have arrived.
Authentication
Send an API key as a bearer token. The key must carry the sites.view 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 GET https://api.zinndigital.com/v1/sites/{siteId}/wordpress/uploads/{uploadId} \
-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
While the upload is open, received_parts lists every part already stored with the right length, read from storage itself; a resuming client sends the rest. After complete the status moves to assembling and then installed or failed (with a message for the customer). An upload is bound to the site it was started on: any other site, or another organisation, gets 404. Requires sites.view and sites.panel_access.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
siteId (path) | Uuid | Yes | Site ID (UUIDv7). |
uploadId (path) | string | Yes | A resumable upload's id, from startSiteWordPressUpload. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | — |
kind | string<plugin, theme> | Yes | — |
status | string<open, assembling, installed, failed> | Yes | — |
size | integer | Yes | — |
part_size | integer | Yes | Bytes per part, chosen by the platform. Every part but the last is exactly this long. |
part_count | integer | Yes | — |
file_name | string | Yes | — |
activate | boolean | Yes | — |
message | string | Yes | On failed, what went wrong, written for the customer. Empty otherwise. |
expires_at | string | Yes | — |
created_at | string | Yes | — |
finished_at | string | Yes | — |
received_parts | integer[] | No | Present while open — the part numbers already stored. |
Errors this endpoint can return
401 · 403 · 404 · 429