Skip to main content
PATCH
/
api
/
content
cURL
curl --request PATCH \
  --url https://recoup-api.vercel.app/api/content \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "video_url": "<string>",
  "template": "<string>",
  "operations": [
    {
      "type": "trim",
      "start": 123,
      "duration": 123,
      "aspect": "<string>",
      "width": 123,
      "height": 123,
      "content": "<string>",
      "font": "<string>",
      "color": "<string>",
      "stroke_color": "<string>",
      "max_font_size": 123,
      "position": "top"
    }
  ],
  "output_format": "mp4"
}
'
{
  "runId": "<string>",
  "status": "triggered"
}

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