Trim or extend a clip

Moves the clip's start and/or end relative to its ORIGINAL bounds (repeated calls do not accumulate; positive extends, negative trims) and re-renders it, through the same pipeline as the dashboard's Adjust length. The result must last 3-180 s and stay inside the source. Extending re-cuts from the source, kept 7 days (410 after). Versioned: the original clip is kept. No video quota. Requires write scope.

post/jobs/{id}/clips/{index}/adjust

Request

  • Base URL: https://katto.tech/api/v1
  • URL: https://katto.tech/api/v1/jobs/{id}/clips/{index}/adjust
  • Auth: HTTP bearer

Path parameters

idstring uuid required
indexinteger required

0-based clip index (position in the job's clips).

Request body

start_offset_secondsnumber

Positive = start earlier (extend), negative = start later (trim).

end_offset_secondsnumber

Positive = end later (extend), negative = end earlier (trim).

Response

Re-render queued

rerender_idstring
status'queued'
status_urlstring uri

Poll GET /jobs/{id}/rerenders/{rerender_id}.

start_secondsnumber

New start, in source seconds.

end_secondsnumber

New end, in source seconds.

duration_secondsnumber
extendedboolean

true when the clip goes past its original bounds.

Changes

No recorded changes to this operation across all 1 revision of this API.