mediaIds.
Each organization has 5 GB of storage.
From a URL
If the file is online, import it. This is the simplest way, and the one AI agents use:ready to attach. The URL must be publicly reachable over http or https.
Uploading a file
For a file on your computer or server, upload in three steps:1
Ask for an upload URL
Send the exact size in bytes.You get back
media.id and an upload object with a url and headers.2
Send the file
PUT the raw bytes to This goes straight to storage, not through the API, so it doesn’t count towards your rate limit.
upload.url with exactly the upload.headers, within 15 minutes:3
Complete it
ready, with its dimensions.Finding files
List media returns ready files, newest first. Filter withtype (image, video, document, or media for anything a post can carry) and search with q, which matches file names, alt text and description: Autoadify’s summary of what a file shows. It’s added in the background, so a new file may not have one yet.

