Ir a la documentación
API

Cambiar el diseño de un formulario

Un diseñador aplica instrucciones escritas al borrador de un formulario y deja el resto como está, como hace Preguntar a la IA en el editor de formularios de la app.

POST/forms/{id}/redesign

Ejecuta la llamada real en tu espacio de trabajo.

POST /forms/{id}/redesign

Un diseñador aplica instrucciones escritas al borrador de un formulario y deja el resto como está, como hace Preguntar a la IA en el editor de formularios de la app.

Ejemplo

Requiere forms:write. instructions dice qué cambiar, hasta 4.000 caracteres: añadir, quitar o reordenar campos, reescribir o traducir los textos, cambiar colores o fuentes.

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"}'
Respuesta
{  "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."]  }}

El cambio se guarda en el borrador, así que un formulario publicado sigue mostrando su versión publicada hasta POST /forms/{id}/publish.

Envía el updatedAt que leíste como expectedUpdatedAt y un guardado hecho entretanto se rechaza con 409 version_conflict. Un guardado hecho mientras trabaja el diseñador se rechaza igual, y no se escribe nada.

Gasta una acción de IA, puede tardar hasta medio minuto y falla de las mismas maneras que diseñar un formulario.

Referencia