---
title: "GET /api/v1/workflows/runs/{runId}/trace"
method: GET
path: "/api/v1/workflows/runs/{runId}/trace"
tags: ["workflows"]
---

# GET /api/v1/workflows/runs/{runId}/trace

`GET /api/v1/workflows/runs/{runId}/trace`

## Path parameters

- `runId` string, required

## Response `200`

Trace events for a workflow run

- object
  - `runId` string
  - `events` object[]
    - `id` string
    - `runId` string
    - `nodeId` string
    - `type` 'STARTED' | 'PROGRESS' | 'COMPLETED' | 'FAILED'
    - `level` 'info' | 'warn' | 'error' | 'debug'
    - `timestamp` string, date-time
    - `message` string, nullable
    - `error` object, nullable
      - `message` string
      - `stack` string
      - `code` string
      - `type` string
      - `details` object
      - `fieldErrors` object
    - `outputSummary` object, nullable
    - `data` object, nullable
    - `metadata` object, nullable
      - `activityId` string
      - `attempt` integer
      - `correlationId` string
      - `streamId` string
      - `joinStrategy` 'all' | 'any' | 'first'
      - `triggeredBy` string
      - `failure` object, nullable
        - `at` string, date-time
        - `reason` object
          - `message` string
          - `name` string
      - `retryPolicy` object, nullable
        - `maxAttempts` integer
        - `initialIntervalSeconds` number
        - `maximumIntervalSeconds` number
        - `backoffCoefficient` number
        - `nonRetryableErrorTypes` string[]
  - `cursor` string, nullable

---

[API](https://skmtc.net/shipsecai/apis/shipsec-studio-api.md) · [All operations](https://skmtc.net/shipsecai/apis/shipsec-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipsecai/shipsec-studio-api/versions/cc60562ad9f3/schema)