Alterar o design de um formulário
Um designer aplica instruções escritas ao rascunho de um formulário e deixa o resto como está, como faz Pedir à IA no construtor de formulários da app.
Executa a chamada real no seu espaço de trabalho.
POST /forms/{id}/redesign
Um designer aplica instruções escritas ao rascunho de um formulário e deixa o resto como está, como faz Pedir à IA no construtor de formulários da app.
Exemplo
Requer forms:write. instructions diz o que mudar, até 4.000 caracteres: adicionar, remover ou reordenar campos, reescrever ou traduzir os textos, mudar cores ou tipos de letra.
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."] }}A alteração é guardada no rascunho, por isso um formulário publicado continua a mostrar a versão publicada até POST /forms/{id}/publish.
Envie o updatedAt que leu como expectedUpdatedAt, e uma gravação feita entretanto é recusada com 409 version_conflict. Uma gravação feita enquanto o designer trabalha é recusada da mesma forma, e nada é escrito.
Gasta uma ação de IA, pode demorar até meio minuto e falha das mesmas formas que conceber um formulário.