BlitzReels
BlitzReelsDocumentation

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/folders
  • GET /v1/workspace/media/assets
  • GET /v1/workspace/media/assets/{asset_id}

List Folders

Terminal
curl "https://www.blitzreels.com/api/v1/workspace/media/folders?parent_folder_id=root" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
Response
{
  "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.

Terminal
curl "https://www.blitzreels.com/api/v1/workspace/media/assets?asset_type=video&limit=20&offset=0" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"
Response
{
  "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

Terminal
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.

Terminal
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=all to combine video, audio, and image results.
  • Use search for quick keyword matching across asset names.
  • limit must be 100 or less. Use offset for the next page.

Workspace Context

Read workspace settings, credits, storage usage, and members for agent context.

Global B-roll Library

Search and import BlitzReels-curated B-roll, images, and audio.

On this page

EndpointsList FoldersList AssetsGet Asset DetailsUse an Asset on the TimelineTipsRelated