API referenceMedia
List media
Find confirmed images and videos in your workspace media library.
curl -X GET "https://example.com/api/v1/media?mediaType=IMAGE&limit=20&offset=0"{ "media": [ { "mediaId": "22222222-2222-4222-8222-222222222222", "fileName": "photo.jpg", "mediaType": "IMAGE", "mimeType": "image/jpeg", "fileSize": 102400, "url": "https://media.example.com/photo.jpg", "duration": null, "width": 1080, "height": 1080, "createdAt": "2026-09-07T12:00:00Z" } ], "total": 1, "hasMore": false}List supported active media visible in the API key's workspace library. mediaType defaults to VIDEO for backward compatibility; pass IMAGE for JPEG. Use mediaId in a supported publishing or scheduling request. Unconfirmed uploads are excluded. The account and media must belong to the same workspace.
Authorization
apiKey AuthorizationBearer <token>
In: header
Query Parameters
mediaType?string
Default
"VIDEO"Value in
- "IMAGE"
- "VIDEO"
limit?integer
Range
1 <= value <= 100Default
20offset?integer
Range
0 <= value <= 10000Default
0Response Body
application/json
application/json