Get Run Overview

{
  "data": {
    "workflow": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Customer Support Call Transcription"
    },
    "run": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "status": "completed",
      "created_at": "2024-01-15T09:30:00Z",
      "started_at": "2024-01-15T09:35:00Z",
      "completed_at": "2024-01-15T10:15:00Z",
      "has_export": true,
      "error": null
    },
    "workflow_snapshot": {
      "definition": {
        "edges": [
          {
            "from": "node-123",
            "to": "node-456"
          }
        ],
        "nodes": [
          {
            "id": "node-123",
            "name": "Transcription Node",
            "type": "transcription"
          },
          {
            "id": "node-456",
            "name": "Validation Node",
            "type": "validation"
          }
        ]
      },
      "node_states": [
        {
          "node_id": "node-123",
          "node_type": "transcription",
          "status": "completed",
          "node_display_name": "Transcription Node",
          "iteration": 1,
          "started_at": "2024-01-15T09:35:00Z",
          "completed_at": "2024-01-15T10:00:00Z",
          "duration_ms": 1500000,
          "error": null
        },
        {
          "node_id": "node-456",
          "node_type": "validation",
          "status": "completed",
          "node_display_name": "Validation Node",
          "iteration": 1,
          "started_at": "2024-01-15T10:00:00Z",
          "completed_at": "2024-01-15T10:15:00Z",
          "duration_ms": 900000,
          "error": null
        }
      ]
    },
    "metric_sections": [
      {
        "key": "audio_metrics",
        "layout": "grid",
        "title": "Audio Duration Totals",
        "metrics": [
          {
            "key": "total_audio_duration",
            "label": "Total Audio Duration",
            "formatted_value": "1h 0m 0s",
            "status": "available",
            "display": {
              "variant": "primary",
              "emphasis": "bold"
            },
            "value": 3600000,
            "unit": "milliseconds",
            "reason": null
          },
          {
            "key": "average_audio_duration",
            "label": "Average Audio Duration",
            "formatted_value": "30s",
            "status": "available",
            "display": {
              "variant": "secondary",
              "emphasis": null
            },
            "value": 30000,
            "unit": "milliseconds",
            "reason": null
          }
        ]
      },
      {
        "key": "validation_metrics",
        "layout": "list",
        "title": "Validation Pass Rates",
        "metrics": [
          {
            "key": "overall_pass_rate",
            "label": "Overall Pass Rate",
            "formatted_value": "95%",
            "status": "available",
            "display": {
              "variant": "success",
              "emphasis": "bold"
            },
            "value": 0.95,
            "unit": null,
            "reason": null
          }
        ]
      }
    ],
    "audio_by_language": [
      {
        "locale_code": "en-US",
        "line_count": 1200,
        "total_duration_ms": 3000000,
        "avg_duration_ms": 2500
      },
      {
        "locale_code": "es-ES",
        "line_count": 300,
        "total_duration_ms": 750000,
        "avg_duration_ms": 2500
      }
    ],
    "validators": [
      {
        "node_id": "node-123",
        "kind": "transcription_quality",
        "label": "Transcription Quality Validator",
        "status": "available",
        "avg_score": 0.92,
        "pass_rate": 0.9,
        "pass_count": 1080,
        "fail_count": 120,
        "retry_count": 15,
        "reason": null
      },
      {
        "node_id": "node-456",
        "kind": "audio_clarity",
        "label": "Audio Clarity Validator",
        "status": "available",
        "avg_score": 0.88,
        "pass_rate": 0.85,
        "pass_count": 1020,
        "fail_count": 180,
        "retry_count": 10,
        "reason": null
      }
    ],
    "capabilities": {
      "validator_drilldown": true,
      "live_trace_timing": true,
      "persisted_aggregates": true
    },
    "future_links": {
      "validator_drilldown": "https://app.onepin.ai/workflows/3fa85f64-5717-4562-b3fc-2c963f66afa6/runs/7c9e6679-7425-40de-944b-e07fc1f90ae7/validators",
      "live_trace": "https://app.onepin.ai/workflows/3fa85f64-5717-4562-b3fc-2c963f66afa6/runs/7c9e6679-7425-40de-944b-e07fc1f90ae7/live-trace"
    }
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-01-15T10:16:00Z"
  }
}

Fetch server-computed overview aggregates for a workflow run.

Returns structured metric sections (e.g. audio duration totals, validation pass rates) grouped by display section, along with per-language audio breakdowns and per-validator scoring summaries. Also includes a workflow_snapshot with the graph definition and per-node completion states.

This endpoint is best suited for a summary/results view after a run completes. It differs from the other run sub-resources as follows:

GET /runs/{run_id} — full run record including the raw definition snapshot.
GET /runs/{run_id}/status — volatile status fields only; for polling.
GET /runs/{run_id}/steps — flat per-node step log with audio playback URLs.
GET /runs/{run_id}/data — paginated script+audio rows for a data table.
GET /runs/{run_id}/overview (this endpoint) — pre-aggregated metrics and node state map for a dashboard/overview panel.

Fetch server-computed overview aggregates for a workflow run. Returns structured metric sections (e.g. audio duration totals, validation pass rates) grouped by display section, along with per-language audio breakdowns and per-validator scoring summaries. Also includes a `workflow_snapshot` with the graph definition and per-node completion states. This endpoint is best suited for a summary/results view after a run completes. It differs from the other run sub-resources as follows: - `GET /runs/{run_id}` — full run record including the raw definition snapshot. - `GET /runs/{run_id}/status` — volatile status fields only; for polling. - `GET /runs/{run_id}/steps` — flat per-node step log with audio playback URLs. - `GET /runs/{run_id}/data` — paginated script+audio rows for a data table. - `GET /runs/{run_id}/overview` (this endpoint) — pre-aggregated metrics and node state map for a dashboard/overview panel.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

run_idstringRequiredformat: "uuid"

Response

Successful Response

dataobject

metaobject

Errors

422

Unprocessable Entity Error