ai

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

Build the site again from its brief, optionally tweaked.

すべての ai エンドポイント

認証

ベアラー トークンとして 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いいえ

返信

名前タイプ必須これがその内容です
buildSiteBuildはい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…
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