Create a Media
POST
/media
PATCH /media/:mediaId to confirm the upload has finished. Once uploaded, the file will be processed asynchronously, and you can check its status using GET /media/:mediaId.uploadUrl within a limited time (typically 15 minutes) and then confirm. The file specifications you provide (width, height, duration, fileSize) should match the actual file you're uploading.Notes
uploadUrl using a PUT request with the file as binary data.uploadUrl expires after a short time (typically 15 minutes) - upload promptly.Content-Type header when uploading (e.g., image/jpeg, video/mp4).PATCH /media/:mediaId to start confirm the uploadGET /media/:mediaId to check processing status before using the media in posts.duration to null. For videos/audio, provide the duration in seconds.destinationType determines how the media can be used: POST_MEDIA for regular post content, POST_LINK for link preview customization.Upload Process
uploadUrl, check the next documented request for example details.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.swonkie.dev/v2/media' \
--header 'X-API-ID: {{apiId}}' \
--header 'X-API-KEY: {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "product-photo.jpg",
"destinationType": "POST_MEDIA"
}'Response Response Example
{
"id": "TWVkaWFJZDk4NzY1NDMyMQ",
"previewUrl": "https://swkdev.blob.core.windows.net/temp/1e66accf-626d-4e1a-aa09-71d7c2e68dca_videoToPost.mp4?sv=2024-05-04&spr=https&st=2026-01-26T20%3A16%3A52Z&se=2026-01-28T20%3A16%3A52Z&sr=b&sp=r&sig=c4DpKX5aNeJJ%2B1nqwWymEB4q%2FrZiJF%2BOqTigJ2WGHpE%3D",
"uploadUrl": "https://swkdev.blob.core.windows.net/temp/1e66accf-626d-4e1a-aa09-71d7c2e68dca_videoToPost.mp4?sv=2024-05-04&spr=https&st=2026-01-26T20%3A16%3A51Z&se=2026-01-28T20%3A16%3A51Z&sr=b&sp=cw&sig=aX0I6vGx0gpVSlNaEVo72vVoM72q4N3diKzre4iE7qg%3D"
}Modified at 2026-03-12 12:25:52