---
title: "POST /concat/highlights"
method: POST
path: "/concat/highlights"
tags: ["Edit"]
---

# POST /concat/highlights

`POST /concat/highlights`

Create a highlights video from the original one. This picks highlight clips and concatenates them into one output video.

## Request body

- object
  - `video_url` string, uri — Source video URL.
  - `trim_segments` object[] — List of segments to combine/merge.
    - `start` integer, required — The start time of the segment in milliseconds.
    - `end` integer, required — The end time of the segment in milliseconds.
    - `transition` 'none' | 'fade' | 'zoom_in' | 'zoom_out' | 'spin' | 'fly_in_from_left' | 'fly_in_from_right' | 'fly_in_from_top' | 'fly_in_from_bottom' | 'fly_out_to_left' | 'fly_out_to_right' | 'fly_out_to_bottom' | 'fly_out_to_top', nullable — The transition between segments.
  - `export` object
    - `format` 'MOV' | 'MP4' | 'WEBM' | 'GIF' — Optionally select one of the output video formats (MP4 is chosen if left blank). Container options are as follows * MOV * MP4 * WEBM * GIF
    - `frame_rate` integer — The output video frame rate.
    - `bitrate` integer — The output video bitrate in kb/s. Leave empty to set automatically and optimize accordingly.

## Response `202`

Requested successfully accepted when doing asynchronous transformation.

- object
  - `transaction_id` string, nullable
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `413` — Request Entity Too Large
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `431` — Request Header Fields Too Large
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/picsart/apis/picsart-programmable-image-apis.md) · [All operations](https://skmtc.net/picsart/apis/picsart-programmable-image-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/picsart/picsart-programmable-image-apis/revisions/726b2a637ae8/schema)