Skip to main content
PATCH
cURL

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Body

application/json

Edit parameters

Requires a video URL. Operations are applied sequentially via ffmpeg.

video_url
string<uri>
required

Input video URL (required)

template
string

Template name for deterministic edit config. If provided, operations are read from the template. See GET /api/content/templates for available options.

operations
object[]

Array of edit operations to apply in order. Required if template is not provided.

output_format
enum<string>
default:mp4

Output format

Available options:
mp4,
webm,
mov

Response

Edit task triggered successfully. Poll via GET /api/tasks/runs using the returned runId.

runId
string
required

Background task run ID. Poll via GET /api/tasks/runs to check progress.

status
enum<string>
required

Status of the edit task

Available options:
triggered