GET `/v1/ai/site-builds`

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

Authenticatie

Stuur een API-sleutel mee als bearer token. De sleutel moet over de permissie sites.view beschikken; een sleutel zonder deze permissie wordt geweigerd met een 403 in plaats van een 404.

Waar je organisatie-id komt te staan

Dit eindpunt accepteert org_id als queryparameter. Laat deze achterwege en de aanroep destilleert je gehele tenant-substructie; stuur deze mee om de aanroep te beperken tot één organisatie.

Uw organisatie-id staat op het scherm met API-sleutels in uw dashboard, naast de sleutel zelf. Dit is in elke aanroep die u doet dezelfde id.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

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

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

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`.

Parameters

Naam	Type	Verplicht	Wat dit is
`org_id (query)`	`Uuid`	Nee	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Reactie

Naam	Type	Verplicht	Wat dit is
`builds`	`SiteBuild[]`	Ja	—
`trial`	`SiteBuilderTrial`	Ja	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`	Ja	The organization's AI credit balance, USD micros.
`spend_micros`	`integer`	Ja	What this organization has spent on the builder in total, USD micros.

Fouten die dit eindpunt kan retourneren

401 · 403 · 422 · 429