---
title: "Assess source resolution and a full-source fallback without starting billable work"
method: GET
path: "/workspace/media/assets/{assetId}/reframe-preflight"
tags: ["Media Library"]
---

# Assess source resolution and a full-source fallback without starting billable work

`GET /workspace/media/assets/{assetId}/reframe-preflight`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/media/assets/{assetId}/reframe-preflight`
- Auth: API key in header `Authorization`

Assess source resolution and a full-source fallback without starting billable work.

## Path parameters

- `assetId` string, required

## Query parameters

- `aspect_ratio` '9:16' | '16:9' | '1:1' | '4:5', required
- `resolution` '720p' | '1080p' | '4k', required
- `crop_width` number
- `crop_height` number

## Response `200`

Successful response

- object
  - `asset_id` string, required
  - `status` 'native_resolution' | 'upscale_required' | 'unknown_dimensions', required
  - `source` object, nullable, required
    - `width` number, required
    - `height` number, required
  - `output` object, required
    - `width` number, required
    - `height` number, required
  - `cover_crop_pixels` object, nullable, required
    - `width` number, required
    - `height` number, required
  - `upscale_factor` number, nullable, required
  - `requested_crop` object, required
    - `width` number, required
    - `height` number, required
  - `subject_detection_performed` false, required
  - `billable_work_started` false, required
  - `fallback` object, required
    - `layout_mode` 'preserve_full_source', required
    - `content_pixels` object, nullable, required
      - `width` number, required
      - `height` number, required
    - `upscale_factor` number, nullable, required
  - `warnings` string[], required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)