BlitzReels
BlitzReelsDocumentation

Timeline Editing API

Trim, split, move, transform, delete, and insert timeline items with the BlitzReels API.

BlitzReels timeline endpoints edit existing project items and insert existing media library assets. All public API timing fields use seconds.

Layers

Lower layer indexes render above higher layer indexes.

  • Layer 0: captions
  • Layer 1: effects and editable overlays
  • Layer 2: B-roll images
  • Layer 3: main video
  • Layer 4: audio tracks
  • Layer 5: backgrounds

Find Items at a Time

Terminal
curl "https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/at?time_seconds=12.5" \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"

Unified Edit Endpoint

Use this endpoint for trim, split, delete, move, transform, and batch variants.

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/edits \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "trim",
    "timeline_item_id": "timeline-item-uuid",
    "trim_start_delta_seconds": 0.5,
    "trim_end_delta_seconds": 0.25,
    "snap_to_frame": true
  }'

Trim

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/trim \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline_item_id": "timeline-item-uuid",
    "trim_start_delta_seconds": 1,
    "trim_end_delta_seconds": 0.5,
    "snap_to_frame": true
  }'

Split

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/split \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline_item_id": "timeline-item-uuid",
    "split_at_seconds": 8.2,
    "snap_to_frame": true
  }'

Move and Transform

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/move \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline_item_id": "timeline-item-uuid",
    "new_start_seconds": 14,
    "new_layer_index": 2
  }'
Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/transform \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline_item_id": "timeline-item-uuid",
    "position_x": 120,
    "position_y": -40,
    "width_px": 720,
    "keep_aspect_ratio": true
  }'

Batch Operations

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/batch-trim \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "timeline_item_id": "id-1", "trim_start_delta_seconds": 0.4 },
      { "timeline_item_id": "id-2", "trim_end_delta_seconds": 0.8 }
    ],
    "snap_to_frame": true
  }'
Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/batch-move \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "timeline_item_id": "id-1", "new_start_seconds": 3 },
      { "timeline_item_id": "id-2", "new_start_seconds": 8, "new_layer_index": 2 }
    ]
  }'
Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/batch-transform \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "timeline_item_id": "id-1", "position_x": 0, "position_y": -120 },
      { "timeline_item_id": "id-2", "width_px": 640 }
    ]
  }'
Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/batch-delete \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline_item_ids": ["id-1", "id-2"],
    "auto_pack": false
  }'

Delete

Terminal
curl -X DELETE https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/items/{timeline_item_id} \
  -H "Authorization: Bearer $BLITZREELS_API_KEY"

Insert Media

Use these routes only with existing media library assets. Images and videos go through /timeline/media or /broll. Audio has a dedicated route.

Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/media \
  -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"
      }
    ],
    "allow_duplicate": true
  }'
Terminal
curl -X POST https://www.blitzreels.com/api/v1/projects/{project_id}/timeline/audio \
  -H "Authorization: Bearer $BLITZREELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "asset_id": "audio-asset-uuid",
        "start_seconds": 0,
        "duration_seconds": 18,
        "volume": 0.35,
        "fade_in_seconds": 0.5,
        "fade_out_seconds": 1,
        "loop": true
      }
    ]
  }'

Audio Library

Search free-to-use provider audio, import it into workspace media, and render it on BlitzReels timelines.

Captions API

Apply caption styles and edit caption words with the BlitzReels API.

On this page

LayersFind Items at a TimeUnified Edit EndpointTrimSplitMove and TransformBatch OperationsDeleteInsert MediaRelated