Get Run | Onepin

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "workflow_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "completed",
    "run_number": 42,
    "token_cost": 3500,
    "created_at": "2024-04-10T14:20:00Z",
    "updated_at": "2024-04-10T14:28:00Z",
    "total_nodes": 15,
    "total_steps": 120,
    "finished_steps": 120,
    "usage_summary": {
      "api_calls": 120,
      "duration_seconds": 360,
      "tokens_used": 3500
    },
    "started_at": "2024-04-10T14:22:00Z",
    "completed_at": "2024-04-10T14:28:00Z",
    "pause_requested_at": null,
    "paused_at": null,
    "error": null,
    "has_export": true,
    "triggered_by": {
      "user_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "user_name": "jane.doe@example.com"
    },
    "credits": 5,
    "definition_snapshot": {
      "execution_config": {
        "retry_policy": "exponential_backoff",
        "timeout_seconds": 300
      },
      "graph": {
        "edges": [
          {
            "from": "node1",
            "to": "node2"
          }
        ],
        "nodes": [
          {
            "config": {
              "source": "user_input"
            },
            "id": "node1",
            "type": "input"
          },
          {
            "config": {
              "operation": "text_analysis"
            },
            "id": "node2",
            "type": "processor"
          }
        ]
      }
    }
  },
  "meta": {
    "request_id": "req_9f8b7c6d5e4a3b2c1d0e",
    "timestamp": "2024-04-10T14:28:01Z"
  }
}

Fetch full detail for a single workflow run.

Returns all run fields plus definition_snapshot — the graph and execution config captured at the moment the run started. The snapshot is returned raw (no config migrations applied), so it faithfully represents the workflow as it existed for this specific execution even if the workflow definition has since been edited.

This is the heaviest run endpoint. For progress polling, use the lighter GET /runs/{run_id}/status which omits the snapshot. For aggregated visual metrics, use GET /runs/{run_id}/overview. For the per-node step log with audio playback URLs, use GET /runs/{run_id}/steps.

Fetch full detail for a single workflow run. Returns all run fields plus `definition_snapshot` — the graph and execution config captured at the moment the run started. The snapshot is returned raw (no config migrations applied), so it faithfully represents the workflow as it existed for this specific execution even if the workflow definition has since been edited. This is the heaviest run endpoint. For progress polling, use the lighter `GET /runs/{run_id}/status` which omits the snapshot. For aggregated visual metrics, use `GET /runs/{run_id}/overview`. For the per-node step log with audio playback URLs, use `GET /runs/{run_id}/steps`.

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

Run detail response, including the graph/execution snapshot.

The snapshot is returned raw — no config migrations are applied — so it reflects the workflow exactly as it existed when the run started, even if the underlying workflow has since been edited.

metaobject

Errors

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/workflows/workflow_id/runs/run_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Path parameters

Headers

Response

Errors