Das Design eines Formulars ändern
Ein Designer wendet schriftliche Anweisungen auf den Entwurf eines Formulars an und lässt den Rest unverändert, wie „KI fragen“ im Formular-Builder der App.
Führt den echten Aufruf in Ihrem Workspace aus.
POST /forms/{id}/redesign
Ein Designer wendet schriftliche Anweisungen auf den Entwurf eines Formulars an und lässt den Rest unverändert, wie „KI fragen“ im Formular-Builder der App.
Beispiel
Erfordert forms:write. instructions sagt, was sich ändern soll, bis zu 4.000 Zeichen: Felder hinzufügen, entfernen oder umordnen, die Texte umschreiben oder übersetzen, Farben oder Schriften ändern.
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."] }}Die Änderung wird im Entwurf gespeichert, sodass ein Live-Formular seine veröffentlichte Version zeigt, bis POST /forms/{id}/publish folgt.
Senden Sie das gelesene updatedAt als expectedUpdatedAt, dann wird ein zwischenzeitliches Speichern mit 409 version_conflict abgelehnt. Ein Speichern, während der Designer arbeitet, wird ebenso abgelehnt, und nichts wird geschrieben.
Es verbraucht eine KI-Aktion, kann bis zu einer halben Minute dauern und scheitert auf dieselbe Weise wie das Entwerfen eines Formulars.