📁 Media Library
List media assets
Retrieve a paginated list of media assets for a workspace with filtering, search, and sort options.
get/api/v1/workspaces/{workspace_id}/media
Path parameters
workspace_idstring required
Example:610a1e660cb41530ca40d372
Workspace ID
Query parameters
pageinteger
Example:1
Page number for pagination
per_pageinteger
Example:20
Number of items per page (max: 100)
type'images' | 'videos'
Example:images
Filter by media type
searchstring
Example:banner
Search media by name (case-insensitive partial match)
sort'recent' | 'oldest' | 'size' | 'a2z' | 'z2a'
Sort order
Response
Media retrieved successfully
Example response
{
"status": true,
"message": "Media retrieved successfully.",
"current_page": 1,
"per_page": 20,
"total": 150,
"last_page": 8,
"from": 1,
"to": 20,
"data": [
{
"id": "625d06734ceb636c2f5e7743",
"_id": "625d06734ceb636c2f5e7743",
"name": "banner.jpg",
"url": "https://storage.googleapis.com/.../banner.jpg",
"mime_type": "image/jpeg",
"extension": "jpg",
"size": 245760,
"type": "image",
"dimensions": {
"width": 1920,
"height": 1080
}
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.