---
title: "Request Downscale"
method: POST
path: "/video/downscale/{source_file_id}"
---

# Request Downscale

`POST /video/downscale/{source_file_id}`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/video/downscale/{source_file_id}`
- Auth: none declared

Request downscaling of a video asset. Callable by users with WRITE on the asset or by admins.

Set force=true to regenerate the proxy even if a matching rendition already exists.

## Path parameters

- `source_file_id` string, uuid, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- DownscaleRequest
  - `new_min_dimension` 360 | 480 | 720 | 1080 | 1440 | 2160
  - `max_framerate` integer
  - `fast` boolean
  - `force` boolean

## Response `200`

Successful Response

- DownscaleResponse
  - `task_id` string, required
  - `estimated_duration_seconds` number

## Other responses

- `422`: Validation Error

---

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