---
title: "Get Workflow Run"
method: GET
path: "/v2/workflows/runs/{run_id}"
tags: ["workflows"]
---

# Get Workflow Run

`GET /v2/workflows/runs/{run_id}`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/workflows/runs/{run_id}`
- Auth: HTTP bearer

Get one existing workflow run and its action snapshot. Captured payloads are omitted by default.

## Path parameters

- `run_id` string, required

## Query parameters

- `include_payloads` boolean: Include captured run context and action input, output, and error payloads. Payloads can contain customer data and are omitted by default.

## Response `200`

Successful Response

- WorkflowRunDetail
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `id` string, required
  - `workflow_id` string, required
  - `workflow_name` string, required
  - `trigger_id` string, required
  - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
  - `source` WorkflowExecutionSource, required
    - `source_type` 'event' | 'schedule', required
    - `name` string, required
    - `event_id` string
    - `occurred_at` string, date-time
  - `trigger_entity_type` string: Entity type that caused the trigger to fire.
  - `trigger_entity_id` string: Entity ID that caused the trigger to fire.
  - `trigger_entity` WorkflowRunEntitySummary
    - `label` string, required
    - `customer_id` string, nullable, required
    - `customer_name` string, nullable, required
    - `payment_plan_id` string, nullable, required
    - `due_date` string, date, nullable, required
  - `action_types` string[]
  - `started_at` string, date-time
  - `completed_at` string, date-time
  - `duration_ms` integer
  - `run_key` string, required: Idempotency key for one actual workflow run.
  - `action_execution_strategy` 'sequential' | 'parallel' | 'percentage', required
  - `condition_results` object: Segment and clause evaluation results captured before the run was created.
  - `payloads_included` boolean, required
  - `captured_payloads` WorkflowCapturedPayloads
    - `context` object
    - `action_inputs` object
    - `action_outputs` object
    - `action_errors` object
  - `actions` WorkflowActionRunDetail[]
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, required
    - `id` string, required
    - `action_id` string, required
    - `position` integer, required
    - `action_type` string, required
    - `status` 'pending' | 'blocked' | 'deferred' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
    - `started_at` string, date-time
    - `scheduled_for` string, date-time
    - `completed_at` string, date-time
    - `duration_ms` integer
    - `artifacts` WorkflowArtifactReference[]
      - `entity_type` string, required
      - `entity_id` string, required
      - `label` string, required
    - `object` string, required: String representing the object's type. Objects of the same type share the same value.
  - `timeline` WorkflowTimelineEvent[]
    - `event_type` 'source' | 'run_created' | 'action_created' | 'run_started' | 'action_started' | 'action_scheduled' | 'action_completed' | 'run_completed', required
    - `occurred_at` string, date-time, required
    - `title` string, required
    - `status` union, required
      - 'event' | 'schedule'
      - 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled'
      - 'pending' | 'blocked' | 'deferred' | 'running' | 'succeeded' | 'failed' | 'cancelled'
    - `action_result_id` string
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `404`: Not Found
- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/3b5ab941f918?raw)