hosting
GET /v1/sites/{siteId}/quota/resources
What this site is allowed per resource, what it is using, and what more costs.
Autenticação
Envie uma chave de API como um token de portador. A chave deve ter a permissão sites.view; uma chave sem ela é recusada com 403, e não 404.
Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.
Experimente
Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/quota/resources \
-H "Authorization: Bearer zdk_live_…"Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API
Detalhes
The **lifecycle** view, where `GET /v1/sites/{siteId}/quota` is the live read of what the box is enforcing right now. Owner ruling 2026-08-16: a plan grants **site slots**; disk, inodes and bandwidth are **per-site** resources with an admin-set default and a paid per-site upgrade. Each entry decomposes the allowance into `base` (the site's own copied default), `granted` (live grants — staff gestures and purchased upgrades) and `total`, because a card showing only the total cannot explain why the number changed when a grant expired. `reverts_at` is when the ceiling next **drops** because a temporary grant ends, so a customer learns before it happens rather than after. `measured_at` is surfaced deliberately: a bar drawn from a two-day-old reading looks identical to one drawn from a fresh reading, and `null` means nothing has ever measured this site. `price_minor` is `null` when no price is published in the caller's currency, and the client must then offer **no upgrade control** rather than one that cannot complete. Only resources this site's driver can actually enforce are listed. On a managed shared package the disk ceiling belongs to the package *type* and an inode limit does not exist at any level, so the list is empty there — the control is absent rather than inert. Requires `sites.view`.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
siteId (path) | Uuid | Sim | Site ID (UUIDv7). |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
frozen | boolean | Sim | Whether the platform has restricted this site **for being over a quota**. It is deliberately not "is this site restricted": that rung is shared with the malware and abuse ladder… |
resources | SiteQuotaResource[] | Sim | Only resources this site's driver can actually enforce. Empty on a managed hosting package, where the disk ceiling belongs to the package type and inodes do not exist. |
Erros que este endpoint pode retornar
401 · 403 · 404 · 429