फ़ॉर्म का डिज़ाइन बदलें
डिज़ाइनर फ़ॉर्म के ड्राफ़्ट पर लिखे निर्देश लागू करता है और बाकी को जैसा है वैसा छोड़ देता है, जैसा ऐप के फ़ॉर्म बिल्डर में "AI से पूछें" करता है।
असली कॉल आपके वर्कस्पेस पर चलाता है।
POST /forms/{id}/redesign
डिज़ाइनर फ़ॉर्म के ड्राफ़्ट पर लिखे निर्देश लागू करता है और बाकी को जैसा है वैसा छोड़ देता है, जैसा ऐप के फ़ॉर्म बिल्डर में "AI से पूछें" करता है।
उदाहरण
forms:write चाहिए। instructions बताता है कि क्या बदलना है, 4,000 अक्षरों तक: फ़ील्ड जोड़ना, हटाना या क्रम बदलना, सामग्री दोबारा लिखना या अनुवाद करना, रंग या फ़ॉन्ट बदलना।
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."] }}बदलाव ड्राफ़्ट में सहेजा जाता है, इसलिए लाइव फ़ॉर्म POST /forms/{id}/publish तक अपना प्रकाशित संस्करण दिखाता रहता है।
जो updatedAt आपने पढ़ा उसे expectedUpdatedAt के रूप में भेजें, तो बीच में हुआ सेव 409 version_conflict के साथ अस्वीकार होता है। डिज़ाइनर के काम करते समय हुआ सेव भी इसी तरह अस्वीकार होता है, और कुछ नहीं लिखा जाता।
इसमें एक AI ऐक्शन लगता है, आधा मिनट तक लग सकता है, और यह उन्हीं तरीकों से विफल होता है जिनसे फ़ॉर्म डिज़ाइन करना।