Aller à la documentation
API

Changer le design d'un formulaire

Un concepteur applique des instructions écrites au brouillon d'un formulaire et laisse le reste tel quel, comme Demander à l'IA dans l'éditeur de formulaires de l'application.

POST/forms/{id}/redesign

Exécute le véritable appel sur votre espace de travail.

POST /forms/{id}/redesign

Un concepteur applique des instructions écrites au brouillon d'un formulaire et laisse le reste tel quel, comme Demander à l'IA dans l'éditeur de formulaires de l'application.

Exemple

Nécessite forms:write. instructions dit ce qu'il faut changer, jusqu'à 4 000 caractères : ajouter, retirer ou réordonner des champs, réécrire ou traduire les textes, changer les couleurs ou les polices.

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"}'
Réponse
{  "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."]  }}

Le changement est enregistré dans le brouillon, donc un formulaire en ligne continue d'afficher sa version publiée jusqu'à POST /forms/{id}/publish.

Envoyez le updatedAt que vous avez lu comme expectedUpdatedAt, et un enregistrement fait entre-temps est refusé avec 409 version_conflict. Un enregistrement fait pendant que le concepteur travaille est refusé de la même façon, et rien n'est écrit.

Il consomme une action IA, peut prendre jusqu'à une demi-minute et échoue de la même façon que la conception d'un formulaire.

Référence