Images

Get an image upload URL

POST/v1/forms/{formId}/images/upload-url

Get a one-time uploadUrl for a picture for this form's image choice questions. Upload the file there, then add it with POST /v1/forms/{formId}/images and the storageId you get back.

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

200 Response

{
  "uploadUrl": "https://luigispizza.com"
}

Path parameters

formIdstringrequired
The form's id.

Response

uploadUrlstringrequired
POST the file to this address as the request body, with its Content-Type and no Authorization header. It answers with { storageId }. The address takes one file and works for an hour, and the storageId works only in this workspace. A file that's never added as a picture is deleted after a day.

Errors answer with a status and the error shape.