ai
POST /v1/ai/site-builds/{siteBuildId}/rebuild
Build the site again from its brief, optionally tweaked.
Autenticação
Envie uma chave de API como um token de portador. A chave deve ter a permissão sites.create; 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 POST https://api.zinndigital.com/v1/ai/site-builds/{siteBuildId}/rebuild \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'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
Runs the builder again on this draft's stored brief. Send `brief` to change it first; omit it to rebuild from exactly what was asked for before. Like `createSiteBuild`, the new draft is returned in `generating` and settles through the same workflow. **A rebuild creates a NEW draft and never edits this one.** The original keeps its files, its cost and — if it was published — its live URL, because the customer paid for it and may be about to decide they preferred it. The new draft records `rebuilt_from` so a screen can show the lineage. It costs exactly what a first build costs and is metered identically; there is no discount for reusing the brief, because the model does the same work. Requires `sites.create` — the same authority as building the first one, and a stronger one than reading a draft, because this spends money.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
siteBuildId (path) | Uuid | Sim | — |
Corpo da requisição
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
brief | string | Não | The tweaked description. Omit to rebuild from the brief already stored. An empty string is refused rather than treated as "no brief". |
provider | string | Não | — |
model | string | Não | — |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
build | SiteBuild | Sim | One "describe a site and we build it" run. `files` is present on the **detail** and create responses and absent from the **list**, deliberately: a generated tree can be a hundre… |
trial | SiteBuilderTrial | Não | 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… |
Erros que este endpoint pode retornar
401 · 403 · 404 · 422 · 429