Import media from a URL
Download an image or video from a link and add it to your workspace media library.
curl -X POST "https://example.com/api/v1/media/imports" \ -H "Content-Type: application/json" \ -d '{ "url": "https://cdn.example.com/photos/launch.png" }'{ "mediaId": "22222222-2222-4222-8222-222222222222", "fileName": "launch.jpg", "mediaType": "IMAGE", "mimeType": "image/jpeg", "fileSize": 412345, "url": "https://media.example.com/launch.jpg", "duration": null, "width": 2160, "height": 1440, "createdAt": "2026-11-08T12:00:00Z"}Download an image or video from a public URL and add it to the API key's workspace media library. Use a direct link to the file, not a web page such as a social media post. Images can be JPEG, PNG, or WebP up to 20 MiB. JPEG images up to 8 MiB are stored unchanged; other images are converted to JPEG with the long side reduced to 2,160 pixels or less. Videos can be MP4 or QuickTime up to 200 MiB; upload larger videos with POST /api/v1/media/uploads. Posteady follows redirects only to public addresses and doesn't send your API key to the URL. The file gets the same checks as an upload confirmation, and its size counts toward the organization's media storage quota. The response is confirmed media that you can use in a publishing or scheduling request right away. Each request stores a new copy. If a request times out, check GET /api/v1/media before you retry.
Authorization
apiKey In: header
Request body
application/json
TypeScript definitions
Use the request body type in TypeScript.
Response body
application/json
application/json
application/json
application/json