GET `/v1/ai/site-builds`

The organization's AI-built sites, its trial state and its builder spend.

Autenticazione

Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione sites.view; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.

L'ID della tua organizzazione va qui

Questo endpoint accetta org_id come parametro di query. Omettilo e la chiamata coprirà l'intero sottoalbero del tuo tenant; invialo per limitare la chiamata a una singola organizzazione.

L'identificativo della tua organizzazione si trova nella schermata delle chiavi API nella tua dashboard, accanto alla chiave stessa. È lo stesso identificativo in ogni chiamata che effettui.

Provalo

Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.

curl -X GET https://api.zinndigital.com/v1/ai/site-builds \
  -H "Authorization: Bearer zdk_live_…"

Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API

Dettagli

Every draft this organization has built, newest first, capped at 50. `files` is deliberately **omitted** from each row here and present on `getSiteBuild` — a generated tree can be a hundred kilobytes and thirty of them inlined is a response no client can render. Read `file_count` for a list, and fetch one build for its contents. `trial` answers whether the one-time free allowance has been used. Requires `sites.view`.

Parametri

Nome	Tipo	Obbligatorio	Che cos'è
`org_id (query)`	`Uuid`	No	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Risposta

Nome	Tipo	Obbligatorio	Che cos'è
`builds`	`SiteBuild[]`	Sì	—
`trial`	`SiteBuilderTrial`	Sì	The one-time free allowance for the AI site builder. One grant per organization, for ever — not monthly, and not per site. `granted` is true because the credit was actually…
`balance_micros`	`integer`	Sì	The organization's AI credit balance, USD micros.
`spend_micros`	`integer`	Sì	What this organization has spent on the builder in total, USD micros.

Errori che questo endpoint può restituire

401 · 403 · 422 · 429