ai

POST /v1/ai/site-builds/{siteBuildId}/rebuild

Build the site again from its brief, optionally tweaked.

모든 ai 엔드포인트

인증

Bearer 토큰으로 API 키를 전송하세요. 키는 반드시 sites.create 권한을 가지고 있어야 하며, 권한이 없는 키는 404가 아닌 403으로 거부됩니다.

이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.

무료 체험하기

대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.

curl -X POST https://api.zinndigital.com/v1/ai/site-builds/{siteBuildId}/rebuild \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

로그인하셨나요? 대시보드의 API 콘솔이 실제 조직 ID와 본인의 키를 자동으로 채우고 라이브 API를 대상으로 요청을 실행하므로 실제 응답을 확인할 수 있습니다. API 콘솔에서 이 엔드포인트를 여세요

상세 정보

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.

매개변수

이름유형필수설명
siteBuildId (path)Uuid

요청 본문

이름유형필수설명
briefstring아니요The tweaked description. Omit to rebuild from the brief already stored. An empty string is refused rather than treated as "no brief".
providerstring아니요
modelstring아니요

응답

이름유형필수설명
buildSiteBuildOne "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…
trialSiteBuilderTrial아니요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…

이 엔드포인트가 반환할 수 있는 오류

401 · 403 · 404 · 422 · 429