Forms

List a form's versions

GET/v1/forms/{formId}/versions

List the form's published versions, newest first, up to 100, with who published each one.

curl "$AYEFORM_API/v1/forms/$FORM_ID/versions" \
  -H "Authorization: Bearer $AYEFORM_KEY"

200 Response

[
  {
    "formId": "v7wskeddca2z4gmve1gy0vfpx75gt60p",
    "version": -9007199254740991,
    "definition": {
      "crust": "Thin crust"
    },
    "theme": {
      "crust": "Thin crust"
    },
    "publishedAt": 1790879400000,
    "publishedBy": {
      "kind": "user",
      "email": "orders@luigispizza.com"
    }
  }
]

Path parameters

formIdstringrequired
The form's id.

Response

A list of objects.

formIdstringrequired
The form's id.
versionintegerrequired
The version's number.
-9007199254740991–9007199254740991
definitionobjectrequired
The form as it was published, in the same shape as a draft.
themeobjectrequired
The full theme the version went live with: the brand theme with the form's overrides on top.
publishedAtnumberrequired
When it was published, in milliseconds since the epoch.
publishedByone of 2required
Who published it. It's a team member's email or an API key's name, or null if unknown.
Show 2 optionsHide 2 options
- Option 1
- null

Errors answer with a status and the error shape.