hosting

GET /v1/sites/deleted

List my deleted sites, and when each stops being recoverable.

Све hosting крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X GET https://api.zinndigital.com/v1/sites/deleted \
  -H "Authorization: Bearer zdk_live_…"

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Sites deleted from the principal's orgs in the last 90 days, newest first, with an unambiguous date for when its backup is purged and the site becomes permanently unrecoverable (purge_due_at). ⚖️ Only rows that still have an action (owner ruling 2026-09-15, D26270). A record deleted more than 90 days ago, a record already purged (the data is gone) and a record already restored (the site is back in GET /v1/sites) are never returned. The bound is enforced here rather than by a client, because a client filter over a cursor-paginated list is a claim about one page. The staff list, GET /v1/admin/deleted-sites, is not bounded. ⛔ purge_due_at is computed by the engine from the live retention policy and must never be recomputed by a client. It comes from the same function the purge sweep selects on, so the date shown and the date acted on cannot drift. A client adding deleted_at + 30 would be a second hardcoded number, and it would be wrong the moment an operator edits the policy (D-W15-10b). ⛔ restorable is a measurement, not a status. It reflects a real check that the backup object exists in storage, so it is false — with reason_code: no_backup — for a site whose backup row claims success over bytes that were never written. A restore button over a backup that does not exist is worse than no button. Requires sites.view only: knowing which of your own sites were deleted, and by when they become unrecoverable, is not a privileged fact.

Параметри

НазивТипОбавезноШта је ово
cursor (query)stringНеOpaque cursor from a previous page's page.next_cursor.
limit (query)integerНеMaximum items to return (page size).

Одговор

НазивТипОбавезноШта је ово
dataDeletedSite[]Да—
pagePageMetaДа—

Грешке које ова крајња тачка може вратити

401 · 403 · 429