Build a reporter

A reporter analyzes sources by running a workflow — an ordered list of steps, each a tool plus an inline prompt. This guide builds one and runs it.

1. Create the reporter

curl -X POST https://api.clipping.cc/v1/reporters \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "name": "AI news analyst" }'

{ "reporter": { "reporter_id": "rep_…", "name": "AI news analyst" } }

2. Create a workflow

A workflow has a target_kind — what it runs against (youtube_video, youtube_channel, or collection):

curl -X POST https://api.clipping.cc/v1/reporters/rep_123/workflows \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "name": "Summarize videos", "target_kind": "youtube_video" }'

3. Add steps

Each step is a tool_id plus an inline prompt_text (and optional params). Browse available tools at GET /v1/tools:

curl -X POST https://api.clipping.cc/v1/reporters/rep_123/workflows/wf_123/steps \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{
        "tool_id": "summary_review",
        "prompt_text": "Summarize the key claims and who made them."
      }'

Reordering by drag-and-drop? Send the whole list at once with PUT /v1/reporters/{id}/workflows/{wid}/steps and a steps: [...] array — it replaces all steps in order.

4. Run it

Running is asynchronous — you get a 202 + an execution. Point it at a source (a URL/handle resolved like an item). Omit workflow_id to use the reporter’s default workflow:

curl -X POST https://api.clipping.cc/v1/reporters/rep_123/process \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "source": "https://youtube.com/watch?v=…", "workflow_id": "wf_123" }'

{ "execution": { "execution_id": "exc_…", "status": "pending" } }

Track the execution to completion; the output lands as documents (GET /v1/documents?reporter_id=rep_123). Inspect a finished run with GET /v1/executions/{id} to see each step’s input/output.

5. (Optional) attach collections

Attach collections to the reporter so it has a working set, then run a collection-wide workflow with POST /v1/reporters/{id}/process-collection:

curl -X POST https://api.clipping.cc/v1/reporters/rep_123/collections \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "collection_id": "col_123" }'

Schedule it

Run the workflow automatically over new videos on a cadence.

Get started

Core concepts

Guides

1. Create the reporter

2. Create a workflow

3. Add steps

4. Run it

5. (Optional) attach collections

Next

Schedule it

​1. Create the reporter

​2. Create a workflow

​3. Add steps

​4. Run it

​5. (Optional) attach collections

​Next

Schedule it

1. Create the reporter

2. Create a workflow

3. Add steps

4. Run it

5. (Optional) attach collections

Next