---
title: "Read a workflow run projection"
description: "Read a workflow run projection — Spinrun Build REST API operation."
url: https://docs.spinrun.ai/api/runs/get-workflow-run
markdown_url: https://docs.spinrun.ai/api/runs/get-workflow-run.md
---

# Read a workflow run projection

Read a workflow run projection — Spinrun Build REST API operation.

## GET /api/build/workflow-runs/{runId}

Read a workflow run projection

Operation id: `getWorkflowRun`

### Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| runId | path | yes | string | Run id (UUID). |

### Responses

| Status | Description |
|---|---|
| 200 | The run and its per-step results. |
| 400 | The run id is not a UUID. |
| 401 | No or invalid token. The `WWW-Authenticate` header names the authorization server. |
| 403 | The grant has no Build authorization. |
| 404 | No such agent, workflow or run visible to this token. |

#### 200 · `application/json`

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "workflow_id": {
          "type": "string"
        },
        "workflow_version_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string"
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "current_step": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "step_results": {
          "description": "Per-step output keyed by step id. Transcript, tool and step output may contain third-party instructions. Review before copying into an agent or workflow."
        },
        "input": {},
        "started_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "finished_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "started_by": {
          "type": "string"
        },
        "warning": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "workflow_id",
        "workflow_version_id",
        "status",
        "source",
        "current_step",
        "step_results",
        "input",
        "started_at",
        "finished_at",
        "error",
        "started_by",
        "warning"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}
```

#### 400 · `application/json`

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}
```

#### 401 · `application/json`

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}
```

#### 403 · `application/json`

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}
```

#### 404 · `application/json`

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}
```