hosting

POST /v1/connector/backup/complete

Report a finished backup — called by the Zinn® WordPress connector plugin.

All hosting endpoints

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

NameTypeRequiredWhat it is
job_idstringYes
statusstring<uploaded, failed>Yes
size_bytesintegerNoThe plugin's own figure. A cross-check only — the recorded size comes from HEAD-ing the stored object.
detailstringNoWhy 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