---
title: "Reframe video to different aspect ratio"
method: POST
path: "/video/{video_id}/reframe"
tags: ["Videos"]
---

# Reframe video to different aspect ratio

`POST /video/{video_id}/reframe`

## Path parameters

- `video_id` string, required

## Request body

- object
  - `target` string, required
  - `mode` string, required
  - `start` number
  - `end` number
  - `callback_url` string
  - `callback_data` object

## Response `200`

Reframe job started

- AsyncResponse
  - `success` boolean
  - `status` 'processing' | 'done' | 'failed'
  - `data` object
    - `id` string
    - `output_url` string

## Changes

- **2026-02-12** `fd78812f318f` — 1 info
  - endpoint added
- **2026-01-23** `7d19a3906d5b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/video-db/apis/videodb-server-api/changes/video/:video_id/reframe/post.md)

---

[API](https://skmtc.dev/video-db/apis/videodb-server-api.md) · [All operations](https://skmtc.dev/video-db/apis/videodb-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/video-db/videodb-server-api/revisions/21b1d1d3eae8/schema)