Skip to main content
POST
Update Clip
For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

Overview

Update the title and/or caption of an existing clip. Clips that are still processing cannot be updated.

Rate Limiting

This endpoint is rate limited to 10 requests per minute per API key.
Cannot update clips that are still processing. Title is limited to 80 characters and caption to 400 characters.
Clips belonging to a cancelled project can’t be edited. The API returns 400“This project was cancelled and can no longer be modified or published.”

Response

string
Unique identifier for the clip
string
ID of the parent project
string
Direct download URL for the final clip (includes captions if enabled)
number
Start time of the clip in the original video (seconds)
number
End time of the clip in the original video (seconds)
number
Duration of the clip in seconds
string
Primary topic or theme of the clip
string
Updated title for the clip
string
Updated caption/description for the clip
string
Language of the clip content
boolean
Whether transcription is translated
array
Array of languages for translation
string
Target dubbing language (for dubbing projects)
string
Script format for transcription (“native” or “roman”)
number
AI-predicted virality score (0-10, higher is better)
integer
Resolution of the exported clip
string
Orientation of the exported clip (“landscape”, “portrait”, “square”)
string
Caption style preset used for this clip
boolean
Whether captions are enabled for this clip
boolean
Whether emojis are added to captions
boolean
Whether keyword highlighting is enabled
object
Clip metadata including technical details
integer
Unix timestamp when the clip was created
integer
Unix timestamp when the clip was last updated

Example Request

Example Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
projectId
string
required

ID of the parent project

clipId
string
required

ID of the clip to update

title
string | null

New clip title (max 80 characters)

caption
string | null

New clip caption (max 400 characters)

Response

200 - application/json

Successful response

id
string
projectId
string
clipUrl
string | null

Direct download URL for the final clip (includes captions if enabled)

startTime
number
endTime
number
duration
number
topic
string | null
title
string | null
caption
string | null
language
string | null
translateTranscription
boolean
translationLanguages
string[]
transcriptionScript
enum<string>
default:native
Available options:
native,
roman
viralityScore
number | null
exportResolution
integer
exportOrientation
enum<string>
Available options:
landscape,
portrait,
square
captionsPreset
string | null
enableCaptions
boolean
enableEmojis
boolean
enableHighlights
boolean
metadata
object
createdAt
integer
updatedAt
integer