Forms

Stop an AI build

POST/v1/forms/{formId}/build/stop

Stop the form's AI build. The questions added so far stay in the draft. If there's no build or it already ended, nothing happens. Returns the latest build, or null.

curl -X POST "$AYEFORM_API/v1/forms/$FORM_ID/build/stop" \
  -H "Authorization: Bearer $AYEFORM_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

200 Response

{
  "buildId": "69gd4qxa20pqkjk58ftkky35797ttbw4",
  "status": "planning",
  "plan": {
    "name": "Luigi's Pizza",
    "steps": [
      {
        "title": "Luigi's Pizza",
        "questions": [
          "Which crust?"
        ]
      }
    ]
  },
  "added": -9007199254740991,
  "skipped": -9007199254740991,
  "skippedLabels": [
    "…"
  ],
  "total": -9007199254740991,
  "error": null,
  "startedAt": 1790879400000,
  "endedAt": 1790879400000
}

Path parameters

formIdstringrequired
The form's id.

Response

Or null.

buildIdstringrequired
The build's id.
statusenumrequired
planning while AI decides the questions, then building while it adds them to the draft. It ends as done, failed or stopped.
One of "planning", "building", "done", "failed", "stopped"
planone of 2required
The form AI planned, with its name and the questions of each step. Null until the plan is ready.
Show 2 optionsHide 2 options
- Option 1
  - namestringrequired
  - stepsarray of objectrequired
    Show 2 fieldsHide 2 fields
    titlestringrequired
    questionsarray of stringrequired
- null
addedintegerrequired
How many of the total questions are in the draft so far.
-9007199254740991–9007199254740991
skippedintegerrequired
How many questions couldn't be built.
-9007199254740991–9007199254740991
skippedLabelsarray of stringrequired
The labels of the questions that couldn't be built.
totalintegerrequired
How many questions AI planned.
-9007199254740991–9007199254740991
errorstring or nullrequired
Why the build failed. Null unless it failed.
startedAtnumberrequired
endedAtnumber or nullrequired

Errors answer with a status and the error shape.