Aller à la documentation
API

Concevoir un formulaire à partir d'un brief

Un concepteur crée un nouveau formulaire d'inscription à partir d'un brief écrit et l'enregistre comme brouillon, comme Créer avec l'IA sur la page Formulaires de l'application.

POST/forms/design

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

POST /forms/design

Un concepteur crée un nouveau formulaire d'inscription à partir d'un brief écrit et l'enregistre comme brouillon, comme Créer avec l'IA sur la page Formulaires de l'application.

Exemple

Nécessite forms:write. brief dit ce que le formulaire doit demander et dire, jusqu'à 4 000 caractères. name est facultatif, et le concepteur nomme le formulaire si vous l'omettez.

curl
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."}'
Réponse
{  "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 réponse est le formulaire entier, tel que GET /forms/{id} le renvoie, avec design.notes sur ce que le concepteur a ajusté. Publiez-le avec POST /forms/{id}/publish.

Il consomme une action IA et peut prendre jusqu'à une demi-minute. Un design qui ne peut pas être rendu valide renvoie 422 invalid_form, un espace de travail qui a déjà autant de formulaires qu'il le peut 422 workspace_limit_reached, un serveur sans modèle 409 ai_not_configured, et un espace de travail à court d'actions IA 429 ai_quota_exceeded. Rien n'est créé dans aucun de ces cas.

Référence