tenancy
GET /v1/orgs/{orgId}/closure-plan
What closing this organization would do.
Doğrulama
API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.
Təşkilatınızın identifikatorunun yerləşdiyi yer
Bu son nöqtə təşkilatınızın identifikatorunu birbaşa URL-də orgId kimi qəbul edir. Onu yola daxil edin — bunun əvəzinə işləyəcək heç bir başlıq və ya sorğu parametri yoxdur.
Təşkilatınızın identifikatoru idarə panelinizdəki API açarları ekranında, açarın özünün yanında yerləşir. Bu, etdiyiniz hər bir sorğuda eyni identifikatordur.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X GET https://api.zinndigital.com/v1/orgs/{orgId}/closure-plan \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
A pure read — opens no transport, arms no workflow, writes nothing — computed by the same function DELETE /v1/orgs/{orgId} runs, so the summary a customer confirms is the plan that then executes. ⛔ Gated on org.delete, not org.read: the plan is a complete inventory of the account (every site, every client org, every retained domain) plus what it owes.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
orgId (path) | Uuid | Bəli | Organization ID (UUIDv7). |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
org_id | Uuid | Bəli | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_type | string | Bəli | — |
site_ids | Uuid[] | Bəli | Sites that will be torn down, through the ordinary teardown — so they land in DeletedSite and stay restorable for the whole retention window. |
reparented_org_ids | Uuid[] | Bəli | D-W15-11 — client orgs re-parented to Zinn®. Never torn down. |
retained_domain_ids | Uuid[] | Bəli | D-W15-12 — domains that keep renewing and stay the customer's. Reported so nobody discovers on an invoice what closing did not stop paying for. |
forfeited_credit_minor | integer | Bəli | ⚖️ Wallet credit this organization holds and will LOSE on closure — "credit is not returnable ever, even on account closure etc." (owner ruling, 2026-08-22). ⛔ Reported for… |
forfeited_credit_currency | string | Bəli | ISO-4217 code for forfeited_credit_minor. |
outstanding_minor | integer | Bəli | Minor units owed (D-W15-13). Mixed currencies report the largest single-currency total, never a sum — adding minor units across currencies is the §2.8 error. |
outstanding_currency | string | Bəli | ISO 4217 code for outstanding_minor; empty when nothing is owed. |
blocked_by_balance | boolean | Bəli | True when the closure would be refused and the org suspended instead. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 429