Перейти к документации
API

Изменение дизайна формы

Дизайнер применяет письменные указания к черновику формы и не трогает остальное, как «Спросить ИИ» в конструкторе форм приложения.

POST/forms/{id}/redesign

Выполняет настоящий запрос в вашем рабочем пространстве.

POST /forms/{id}/redesign

Дизайнер применяет письменные указания к черновику формы и не трогает остальное, как «Спросить ИИ» в конструкторе форм приложения.

Пример

Требуется forms:write. instructions говорит, что изменить, до 4000 символов: добавить, убрать или переставить поля, переписать или перевести тексты, сменить цвета или шрифты.

curl
curl -X POST "$OE/forms/frm_3b9d2e7a1c4f80d56e2a9b14/redesign" -H "$AUTH" -H 'content-type: application/json' -d '{  "instructions": "Add a required company field after the name, and make the button say Join.",  "expectedUpdatedAt": "2026-09-30T09:12:44.000Z"}'
Ответ
{  "object": "form",  "id": "frm_3b9d2e7a1c4f80d56e2a9b14",  "name": "Newsletter sign-up",  "status": "live",  "hasUnpublishedChanges": true,  "design": {    "notes": ["Added a required company field after the name.", "Changed the button to say Join."]  }}

Изменение сохраняется в черновик, поэтому опубликованная форма показывает свою опубликованную версию до POST /forms/{id}/publish.

Передайте прочитанный updatedAt как expectedUpdatedAt, и сохранение, сделанное в промежутке, будет отклонено с 409 version_conflict. Сохранение во время работы дизайнера отклоняется так же, и ничего не записывается.

Тратит одно действие ИИ, может занять до полуминуты и завершается ошибкой в тех же случаях, что и дизайн формы.

Справочник