TraceeDocs

Clips

Follow a clipping job

Waits up to about 45 seconds, then returns its stage and progress; once done, each clip's clip_id, media_id, score, hook, title, copy and transcript, best first.

GEThttps://traceeai.com/api/v1/clips/{job_id}

CLI:tracee clips get·MCP:mediaaction clip_status

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

    From POST /api/v1/clips (leave out to list recent jobs)

    uuid

Response

Errors
  • 200Done.

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