hosting
POST /v1/connector/backup/complete
Report a finished backup — called by the Zinn® WordPress connector plugin.
Authentication
This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.
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/connector/backup/complete \
-H "Content-Type: application/json" \
-d '{ "job_id": <string>, "status": <string<uploaded, failed>> }'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
Settles the job the plugin claimed. Same bearer token, same silent treatment of an unknown one. ⛔ **The reported `size_bytes` is a cross-check, not the record.** We HEAD the stored object ourselves, because a truncated upload that reports success is indistinguishable from a good one until somebody tries to restore it — and because a site could otherwise report `uploaded` having written nothing, leaving a restore button over an object that does not exist. A `failed` report settles the row so it is not left running for ever. The detail is kept for staff and never shown to the customer: it is untranslated English and can carry a filesystem path from their server.
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
job_id | string | Yes | — |
status | string<uploaded, failed> | Yes | — |
size_bytes | integer | No | The plugin's own figure. A cross-check only — the recorded size comes from HEAD-ing the stored object. |
detail | string | No | Why it failed. Kept for staff and never rendered to the customer: untranslated English that can carry a path from their server. |
Errors this endpoint can return
422 · 429