Skip to main content


Many sources allow for sending and receiving attachments such as files, videos, images or audio recordings. In order to persist media you need to enable the media service by providing a storage option in your airy.yaml config.

Upload a file

POST /media.upload

Expects a multi-part form upload including the original filename

Sample curl

curl http://localhost/media.upload \
-H "Content-Type: multipart/form-data" \
--form file=@test_image.jpg

Sample response

"media_url": ""