PUT `/v1/ai/site-builds/{siteBuildId}/files`

Replace one generated file's contents.

Аутентификация

Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.create; ключ без него отклоняется с кодом 403, а не 404.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X PUT https://api.zinndigital.com/v1/ai/site-builds/{siteBuildId}/files \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "path": <string>, "content": <string> }'

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

Writes content to path in this draft, creating the file if it does not exist. Adding robots.txt to a generated site is the same act as correcting index.html, so both are allowed; the size and file-count caps are what bound it. The path goes through the same validator the builder's own output does — relative, no traversal, and a suffix a static host will serve and that cannot execute on our side. Images cannot be edited here because they are not text. Refused on a published build (published). A published draft's files are what visitors are seeing; editing them here would make the record disagree with the live site silently, until somebody republished for an unrelated reason. Requires sites.create.

Параметры

Имя	Тип	Обязательно	Что это
`siteBuildId (path)`	`Uuid`	Да	—

Тело запроса

Имя	Тип	Обязательно	Что это
`path`	`string`	Да	Relative path inside the generated site, e.g. `index.html`.
`content`	`string`	Да	The file's complete new contents. May be empty.

Ответ

Имя	Тип	Обязательно	Что это
`build`	`SiteBuild`	Да	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 hundred…
`trial`	`SiteBuilderTrial`	Нет	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

PUT /v1/ai/site-builds/{siteBuildId}/files