GET `/v1/ai/site-builds`

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

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.

Onde vai o ID da sua organização

Este endpoint aceita org_id como parâmetro de consulta. Omita-o e a chamada abrangerá toda a sua subárvore de locatários; envie-o para restringir a chamada a uma única organização.

O ID da sua organização está na tela de chaves de API no seu painel, ao lado da própria chave. É o mesmo ID em todas as chamadas que você fizer.

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/ai/site-builds \
  -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

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

Parâmetros

Nome	Tipo	Obrigatório	O que é
`org_id (query)`	`Uuid`	Não	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Resposta

Nome	Tipo	Obrigatório	O que é
`builds`	`SiteBuild[]`	Sim	—
`trial`	`SiteBuilderTrial`	Sim	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`	Sim	The organization's AI credit balance, USD micros.
`spend_micros`	`integer`	Sim	What this organization has spent on the builder in total, USD micros.

Erros que este endpoint pode retornar

401 · 403 · 422 · 429