Skip to main content
POST
/
automation
/
update-clip
Update Clip
curl --request POST \
  --url https://public.reap.video/api/v1/automation/update-clip \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "clipId": "<string>",
  "title": "<string>",
  "caption": "<string>"
}
'
{
  "id": "<string>",
  "projectId": "<string>",
  "clipUrl": "<string>",
  "clipWithCaptionsUrl": "<string>",
  "startTime": 123,
  "endTime": 123,
  "duration": 123,
  "topic": "<string>",
  "title": "<string>",
  "caption": "<string>",
  "language": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "viralityScore": 123,
  "reframeClips": true,
  "exportResolution": 123,
  "exportOrientation": "landscape",
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "createdAt": 123,
  "updatedAt": 123
}

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 250 characters.

Response

id
string
Unique identifier for the clip
projectId
string
ID of the parent project
clipUrl
string
Direct download URL for the final clip (includes captions if enabled)
clipWithCaptionsUrl
string
Deprecated. Use clipUrl instead, which now includes captions when enabled.
startTime
number
Start time of the clip in the original video (seconds)
endTime
number
End time of the clip in the original video (seconds)
duration
number
Duration of the clip in seconds
topic
string
Primary topic or theme of the clip
title
string
Updated title for the clip
caption
string
Updated caption/description for the clip
language
string
Language of the clip content
translateTranscription
boolean
Whether transcription is translated
translationLanguages
array
Array of languages for translation
dubbingLanguage
string
Target dubbing language (for dubbing projects)
transcriptionScript
string
Script format for transcription (“native” or “roman”)
viralityScore
number
AI-predicted virality score (0-10, higher is better)
reframeClips
boolean
Whether this clip is reframed
exportResolution
integer
Resolution of the exported clip
exportOrientation
string
Orientation of the exported clip (“landscape”, “portrait”, “square”)
captionsPreset
string
Caption style preset used for this clip
enableCaptions
boolean
Whether captions are enabled for this clip
enableEmojis
boolean
Whether emojis are added to captions
enableHighlights
boolean
Whether keyword highlighting is enabled
metadata
object
Clip metadata including technical details
createdAt
integer
Unix timestamp when the clip was created
updatedAt
integer
Unix timestamp when the clip was last updated

Example Request

curl -X POST "https://public.reap.video/api/v1/automation/update-clip" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "65f1a2b3c4d5e6f7a8b9c0d2",
    "clipId": "65f1a2b3c4d5e6f7a8b9c0d4",
    "title": "Updated Clip Title",
    "caption": "A new caption for this clip"
  }'

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 250 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)

clipWithCaptionsUrl
string | null
deprecated

Deprecated. Use clipUrl instead.

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
reframeClips
boolean
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