Uploading photos

Photos go straight to EMS’s private storage, not through the API, and EMS then processes them exactly like uploads in the dashboard: it checks the file really is an image, straightens it, strips hidden metadata such as location, resizes it and makes a thumbnail. You need a key with the media:write scope. JPEG, PNG, GIF and WebP are accepted, up to 20 MB.

Start the upload

Tell EMS about the file: its name, type and exact size in bytes.

curl -u "$EMS_PUBLIC_KEY:$EMS_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -X POST https://ems-api.aventia.africa/api/public/v1/media/uploads \
  -d '{ "filename": "wanjiru.jpg", "content_type": "image/jpeg", "size": 248331 }'

{
  "id": "019a…",
  "status": "pending",
  "upload": { "url": "https://ems-media.aventia.africa/ems-media", "fields": { "key": "…", "policy": "…", "…": "…" } },
  "expires_at": "2026-11-05T20:15:00Z"
}

Post the file to storage

Send a multipart/form-data POST to upload.url with every upload.fields entry first and the file last, in a field named file. Don’t add your API key here; the signed fields are the permission. The form works for 15 minutes, for this one file only.

# Build -F options from upload.fields, then add the file last.
curl -X POST "$UPLOAD_URL" \
  -F "key=$KEY" -F "policy=$POLICY" -F "x-amz-signature=$SIGNATURE" … \
  -F "file=@wanjiru.jpg;type=image/jpeg"

const form = new FormData()
for (const [k, v] of Object.entries(start.upload.fields)) form.append(k, v)
form.append('file', new Blob([await fs.promises.readFile('wanjiru.jpg')], { type: 'image/jpeg' }), 'wanjiru.jpg')
const res = await fetch(start.upload.url, { method: 'POST', body: form })
if (!res.ok) throw new Error(`storage said ${res.status}`)

with open("wanjiru.jpg", "rb") as f:
    r = requests.post(start["upload"]["url"], data=start["upload"]["fields"],
                      files={"file": ("wanjiru.jpg", f, "image/jpeg")}, timeout=60)
r.raise_for_status()

The type and size must match what you declared in step 1, or storage refuses the file.

Complete it and wait

curl -u "$EMS_PUBLIC_KEY:$EMS_SECRET_KEY" -X POST \
  https://ems-api.aventia.africa/api/public/v1/media/uploads/$UPLOAD_ID/complete

Then poll every second or two until status is ready or failed:

curl -u "$EMS_PUBLIC_KEY:$EMS_SECRET_KEY" \
  https://ems-api.aventia.africa/api/public/v1/media/uploads/$UPLOAD_ID

{ "id": "019a…", "status": "ready", "item": { "id": "019a…", "url": "…", "thumb_url": "…" } }

Use item.id as a speaker’s photo_media_id. If it failed, error says why (for example, the file isn’t really an image).

Get started

Using the API

Guides

More