Media Library
Browse folders and media assets in the BlitzReels workspace library.
The media library is a workspace-wide catalog of videos, images, and audio. Use it to discover assets, then place them on a project timeline with B-roll or overlays.
Endpoints
GET /v1/workspace/media/foldersGET /v1/workspace/media/assetsGET /v1/workspace/media/assets/{asset_id}
List Folders
curl "https://www.blitzreels.com/api/v1/workspace/media/folders?parent_folder_id=root" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"{
"folders": [
{
"id": "folder-uuid",
"name": "Brand Pack",
"createdAt": "2026-02-04T10:05:00Z"
}
],
"count": 1
}List Assets
Use filters like asset_type, folder_id, search, and pagination controls to find what you need.
curl "https://www.blitzreels.com/api/v1/workspace/media/assets?asset_type=video&limit=20&offset=0" \
-H "Authorization: Bearer $BLITZREELS_API_KEY"{
"assets": [
{
"id": "asset-uuid",
"type": "video",
"name": "Office B-roll",
"durationSeconds": 4.2,
"createdAt": "2026-02-04T09:58:00Z"
}
],
"totalCount": 42,
"limit": 20,
"offset": 0
}Get Asset Details
curl https://www.blitzreels.com/api/v1/workspace/media/assets/{asset_id} \
-H "Authorization: Bearer $BLITZREELS_API_KEY"Use an Asset on the Timeline
Once you have an asset_id, insert it as B-roll.
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/broll \
-H "Authorization: Bearer $BLITZREELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"asset_id": "asset-uuid",
"start_seconds": 5,
"duration_seconds": 3,
"position_preset": "fullscreen",
"animation_preset": "fadeIn"
}
]
}'Tips
- Use
asset_type=allto combine video, audio, and image results. - Use
searchfor quick keyword matching across asset names. limitmust be 100 or less. Useoffsetfor the next page.