Update Clip
Manage Projects
Update Clip
Update a clip’s title and caption
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
200 - application/json
Successful response
Direct download URL for the final clip (includes captions if enabled)
Available options:
native, roman Available options:
landscape, portrait, square