Skip to main content
Every file lives in your organization’s media library, the same one you see in the Autoadify app. Attach files to a post with their ids in 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:
The response is the media item, already 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 upload.url with exactly the upload.headers, within 15 minutes:
This goes straight to storage, not through the API, so it doesn’t count towards your rate limit.
3

Complete it

The media is now ready, with its dimensions.

Finding files

List media returns ready files, newest first. Filter with type (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.

Deleting

Delete media removes a file permanently. It’s refused while the file is attached to a post that hasn’t been published yet, so you can’t break a scheduled post by accident. Posts already published keep their copy on the platforms.