Diseñar un formulario a partir de una descripción
Un diseñador crea un formulario de suscripción nuevo a partir de una descripción escrita y lo guarda como borrador, como hace Crear con IA en la página Formularios de la app.
Ejecuta la llamada real en tu espacio de trabajo.
POST /forms/design
Un diseñador crea un formulario de suscripción nuevo a partir de una descripción escrita y lo guarda como borrador, como hace Crear con IA en la página Formularios de la app.
Ejemplo
Requiere forms:write. brief dice lo que el formulario debe preguntar y decir, hasta 4.000 caracteres. name es opcional, y el diseñador pone nombre al formulario si lo omites.
curl -X POST "$OE/forms/design" -H "$AUTH" -H 'content-type: application/json' -d '{ "brief": "A waitlist for our beta: email, first name and company, with a line on what joining means. A dark green button that says Join the waitlist."}'{ "object": "form", "id": "frm_7d1f3b5a9c2e48f06b1d3f5a", "name": "Beta waitlist", "status": "draft", "design": { "notes": ["Made the company field optional, since the brief did not ask for it to be required."] }}La respuesta es el formulario entero, como lo devuelve GET /forms/{id}, con design.notes sobre lo que ajustó el diseñador. Publícalo con POST /forms/{id}/publish.
Gasta una acción de IA y puede tardar hasta medio minuto. Un diseño que no se puede hacer válido es un 422 invalid_form, un espacio de trabajo que ya tiene tantos formularios como puede, un 422 workspace_limit_reached, un servidor sin modelo, un 409 ai_not_configured, y un espacio de trabajo sin acciones de IA, un 429 ai_quota_exceeded. En ninguno de ellos se crea nada.