API
양식 디자인 변경
디자이너가 양식의 초안에 글로 쓴 지시를 적용하고 나머지는 그대로 둡니다. 앱의 양식 빌더에 있는 AI에게 요청과 같습니다.
POST/forms/{id}/redesign
워크스페이스에 실제 호출을 실행합니다.
POST /forms/{id}/redesign
디자이너가 양식의 초안에 글로 쓴 지시를 적용하고 나머지는 그대로 둡니다. 앱의 양식 빌더에 있는 AI에게 요청과 같습니다.
예시
forms:write가 필요합니다. instructions에는 바꿀 내용을 최대 4,000자로 씁니다. 필드 추가, 제거, 순서 변경, 문구 다시 쓰기나 번역, 색이나 글꼴 변경 등입니다.
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로 거부됩니다. 디자이너가 작업하는 동안의 저장도 같은 방식으로 거부되고, 아무것도 쓰이지 않습니다.
AI 작업 1회를 쓰고 최대 30초가 걸릴 수 있으며, 양식 디자인과 같은 이유로 실패합니다.