---
title: "Re-render a clip (new layout, captions, or dub)"
method: POST
path: "/jobs/{id}/clips/{index}/rerender"
---

# Re-render a clip (new layout, captions, or dub)

`POST /jobs/{id}/clips/{index}/rerender`

## Request

- Base URL: `https://katto.tech/api/v1`
- URL: `https://katto.tech/api/v1/jobs/{id}/clips/{index}/rerender`
- Auth: HTTP bearer

Re-render one finished clip with a new reframe layout_mode and/or caption_style and/or dubbing. Does NOT consume video quota (it edits an existing clip); the original clip url is preserved and the result is versioned. Returns a rerender_id; poll GET /v1/jobs/{id}/rerenders/{rerender_id}. Requires write scope. The clip must carry editing metadata (recent jobs).

## Path parameters

- `id` string, uuid, required
- `index` integer, required

## Request body

- object: Provide at least one of layout_mode, caption_style, dub.
  - `layout_mode` 'face_tracking' | 'wide' | 'split_screen' | 'stacked' | 'passthrough' | 'grid_3' | 'grid_4'
  - `caption_style` string
  - `dub` string[]

## Response `202`

Re-render queued

- object
  - `rerender_id` string
  - `status` string
  - `status_url` string, uri

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `429`: Error

---

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