Get Run | OnePin

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "workflow_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "completed",
    "run_number": 42,
    "token_cost": 350,
    "created_at": "2024-01-15T09:29:45Z",
    "updated_at": "2024-01-15T09:32:05Z",
    "total_nodes": 12,
    "total_steps": 48,
    "finished_steps": 48,
    "usage_summary": {
      "api_calls": 48,
      "memory_mb": 256,
      "duration_seconds": 120
    },
    "started_at": "2024-01-15T09:30:00Z",
    "completed_at": "2024-01-15T09:32:00Z",
    "error": null,
    "has_export": true,
    "triggered_by": {
      "user_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "user_name": "jane.doe@example.com"
    },
    "credits": 5,
    "definition_snapshot": {
      "nodes": [
        {
          "id": "node-1",
          "type": "trigger",
          "config": {
            "event": "file_uploaded"
          }
        },
        {
          "id": "node-2",
          "type": "action",
          "config": {
            "action_type": "send_email",
            "template_id": "tmpl_12345"
          }
        }
      ],
      "edges": [
        {
          "from": "node-1",
          "to": "node-2"
        }
      ],
      "settings": {
        "retry_on_failure": true,
        "max_retries": 3
      }
    }
  },
  "meta": {
    "request_id": "req_4f5e6d7c8b9a0c1d2e3f4a5b",
    "timestamp": "2024-01-15T09:32:05Z"
  }
}

Fetch a workflow run by id.

Includes definition_snapshot — the graph/execution config captured when the run started, returned raw (no config migrations applied) so it reflects the workflow exactly as it existed for this run.

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