tenancy

DELETE /v1/orgs/{orgId}

Close an organization.

Sve tenancy krajnje tačke

Autentifikacija

Pošaljite API ključ kao bearer token. Ključ mora imati dozvolu org.delete; ključ bez nje se odbija sa 403, a ne sa 404.

Gde ide ID vaše organizacije

Ovaj krajnji tačka uzima ID vaše organizacije direktno u URL-u kao orgId. Zamenite ga u putanji — ne postoji zaglavlje ili query parametar koji to može zameniti.

ID vaše organizacije nalazi se na ekranu sa API ključevima u vašoj kontrolnoj tabli, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamenite bilo šta u uglastim zagradama sopstvenim vrednostima, a ključni placeholder sa ključem sa vaše kontrolne table.

curl -X DELETE https://api.zinndigital.com/v1/orgs/{orgId} \
  -H "Authorization: Bearer zdk_live_…"

Prijavljeni ste? API konzola na vašoj kontrolnoj tabli automatski popunjava ID vaše stvarne organizacije i vaš sopstveni ključ, i izvršava zahtev nad API-jem uživo tako da možete videti stvarni odgovor. Otvorite ovu krajnju tačku u API konzoli

Detalji

Closes the account: re-parents its client orgs to Zinn® (D-W15-11), tears every one of its own sites down through the ordinary `SiteTeardownWorkflow` (so they land in `DeletedSite` and stay restorable for the whole retention window), and **keeps its domains renewing** (D-W15-12). Requires `org.delete` **on that org** — held by the customer `owner` and by `super_admin`, so this is a customer's own decision as well as a staff one. ⛔ **An org that owes money is suspended, never torn down** (D-W15-13): the balance check runs first, performs the suspension itself, and answers **409**. Closing is not a route out of an unpaid invoice. ⛔ Answers **200 with the result**, not 204: `failures` is what says a run was partial and left the org OPEN for a retry, and the counts are what an operator reconciles a vendor invoice against.

Parametri

NazivVrstaObaveznoŠta je ovo
orgId (path)UuidDaOrganization ID (UUIDv7).

Odgovor

NazivVrstaObaveznoŠta je ovo
org_idUuidDaUUIDv7 identifier — sortable by creation time (docs/02 §8).
sites_torn_downUuid[]Da
orgs_reparentedUuid[]Da
domains_retainedUuid[]Da
failuresstring[][]Da`[site_id, error_class]` pairs for sites whose teardown could not be armed. ⛔ **Non-empty means the org is still OPEN** and the closure should be retried — it is never silently…

Greške koje ovaj krajnji tačka može da vrati

401 · 403 · 404 · 409 · 429