# Trim video (`trim_video`)
> Keeps one time range or several and cuts everything else, with times given in seconds.
- Area: [Studio editing](https://mcp.dadan.io/tools/studio-editing.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (the explicit overwrite_original:true path irreversibly replaces the original's render)
- AI credits: yes
- Available on read-only connections: no

## Example prompt
"Trim my recording down to just the 2 to 5 minute stretch"

## Parameters
- `video_id` (string, required): The video's guid (from search_videos or get_video).
- `start_seconds` (number): Start of the single range to keep, in seconds. Use with end_seconds.
- `end_seconds` (number): End of the single range to keep, in seconds. Use with start_seconds.
- `keep_segments` (object[]): Several ranges to keep, each {start_seconds, end_seconds} — overrides the single pair; the kept segments are joined in order.
- `overwrite_original` (boolean): true = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

## Description for AI assistants
Trim a video: keep one time range (start_seconds + end_seconds) or several (keep_segments) and cut everything else. Times are in SECONDS from the start of the video. overwrite_original default false = renders a NEW copy, original untouched; true OVERWRITES the original's render. Returns a processing job — poll get_job_status; rendering takes a while.


## Used in these prompts

- Clip the best moment for social (Marketing): "Find the strongest 45 seconds in my talk [link], trim to just that moment, reframe it vertical for Reels and TikTok, and add a bold text overlay of the key quote."
- Answer a question with a timestamped clip (Success & Support): "Find the moment in [link] where we explain [the billing settings], trim just that part, and give me a link I can send to a customer who asked."
- Protect privacy before sharing a recording (Success & Support): "Cut out the part around [2:15] where the customer's details appear on screen in [link], then give me a password-protected share link of the clean copy."
- Spin a long video into a Short (Creators & Social): "Pull the best 30 seconds from [link], reframe it vertical, add a punch-in zoom at the key moment, and lay background music from [music link] under it."
Canonical page: https://mcp.dadan.io/tools/trim-video
