Images

List images

GET/v1/forms/{formId}/images

List the pictures added to this form, newest first, up to 200. Each has its public url.

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

200 Response

[
  {
    "id": "bd4a5bvqj5ae2q8d9e9t94cr8y5q3jxy",
    "formId": "v7wskeddca2z4gmve1gy0vfpx75gt60p",
    "url": "https://luigispizza.com",
    "contentType": "image/jpeg",
    "size": 184320,
    "width": 1,
    "height": 1,
    "sourceUrl": "https://luigispizza.com",
    "createdAt": 1790879400000
  }
]

Path parameters

formIdstringrequired
The form's id.

Response

A list of objects.

idstringrequired
The picture's id. Put it in an image choice option's imageId.
formIdstringrequired
urlstringrequired
Where visitors load the picture from. The address is public and never changes, and it's cached for a year. A new picture always gets a new id.
contentTypestringrequired
PNG, JPEG, WebP, GIF or SVG, read from the file's bytes.
sizeintegerrequired
Size in bytes.
-9007199254740991–9007199254740991
widthnumberrequired
Width in pixels.
heightnumberrequired
Height in pixels.
sourceUrlstring or nullrequired
The url the picture was fetched from. Null for an upload.
createdAtnumberrequired
When it was added, in milliseconds since the epoch.

Errors answer with a status and the error shape.