TraceeDocs

Clips

Re-make one clip

Trim it (start and end in seconds of the source video), change the hook (empty removes it), the captions or their look, or let a model add effects. Under a minute in the background; GET /clips/{job_id} shows the new media_id.

PATCHhttps://traceeai.com/api/v1/clips/{job_id}/clips/{clip_id}

CLI:tracee clips edit·MCP:mediaaction clip_edit

Authorizations

  • Authorizationstringheaderrequired

    Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

  • Tracee-Workspacestring

    For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.

    uuid

Path parameters

  • job_idstringrequired

    The clip's job

    uuid

  • clip_idstringrequired

    The clip, from clip_status. From GET /api/v1/clips/{job_id} job_id=<job_id>

    uuid

Body

application/json
  • startnumber

    New start, seconds into the source video

  • endnumber

    New end, seconds into the source video

  • hookstring

    The line over the first 5 seconds; empty string removes it

    up to 120 characters

  • captionsboolean

    Burn captions in; default true

  • caption_stylestring

    The caption look

    Available options:defaulthormozipilllimeonewordcleanglowbeast

  • effectsstring

    Auto lets a model place zooms, colour pops and flashes; none removes them

    Available options:autonone

Response

Errors
  • 200Already done.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.

  • 202Started or still running: follow it with the id in the answer.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.