hosting
DELETE /v1/sites/{siteId}/external-backup
Remove our access to an externally hosted site.
Authenticatie
Stuur een API-sleutel mee als bearer token. De sleutel moet over de permissie hosting.backup.manage beschikken; een sleutel zonder deze permissie wordt geweigerd met een 403 in plaats van een 404.
Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.
Probeer het
Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.
curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/external-backup \
-H "Authorization: Bearer zdk_live_…"Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console
Details
Deletes the connection and forgets the stored credential. The backups themselves are **not** deleted. A customer disconnecting us may be doing it precisely so they can restore elsewhere, and their existing restore points are theirs — they expire on the normal retention schedule and are all still downloadable. Requires `hosting.backup.manage`.
Parameters
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
siteId (path) | Uuid | Ja | Site ID (UUIDv7). |
Reactie
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
configured | boolean | Ja | False when nobody has connected this site yet. The rest of the object is still present and empty — a screen must not have to tell "not set up" from "failed to load" by the absen… |
channel | ExternalBackupChannel | string<> | Ja | Empty string when `configured` is false. |
enabled | boolean | Ja | A disabled connection is paused, not deleted — the set-up survives. |
can_restore | boolean | Ja | Whether we can push a backup back down this channel. **False for `connector`**, and that is not a limitation to route around: a WordPress plugin cannot run inside a WordPress to… |
summary | string | Ja | One sentence stating what this connection can and cannot do, composed server-side so every surface says the same thing about the backup/restore asymmetry. |
ssh_host | string | Ja | Empty on a `connector` connection. |
ssh_port | integer | Ja | — |
ssh_username | string | Ja | — |
remote_path | string | Ja | The site's document root — what we archive, and what we restore into. |
credential_present | boolean | Ja | Whether a credential is stored in our secret store. The credential itself is never returned by any endpoint. |
last_verified_at | string | Ja | Null when the connection has never been checked. |
last_verified_ok | boolean | Ja | Null means never checked, which is not the same as failing — the absence of a measurement is not a measurement. |
last_verify_detail | string | Ja | — |
Fouten die dit eindpunt kan retourneren
401 · 403 · 404 · 422