---
title: "GET /v1/runs/{id}"
method: GET
path: "/v1/runs/{id}"
---

# GET /v1/runs/{id}

`GET /v1/runs/{id}`

Get a specific run by ID

## Path parameters

- `id` string, required

## Response `200`

OK

- GetRunSuccessResponse
  - `code` integer
  - `data` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityRun
    - `executionState` object
    - `finishedAt` string
    - `id` string
    - `organizationId` string
    - `propValues` object
    - `startedAt` string
    - `status` 'running' | 'waiting' | 'success' | 'failure' | 'cancelled'
    - `triggerSource` string
    - `triggeredBy` string
    - `workflowDefinition` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityWorkflowDefinition — Definition is the full workflow graph to execute. Must contain a "root" node with type "manual". All action nodes referenced in children arrays must be present.
      - `inputSchema` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityWorkflowInput[]
        - `description` string
        - `key` string
        - `required` boolean
        - `type` string — "string", "number", "boolean", "object", "array"
      - `nodes` object, required
      - `sensitivePropKeys` string[]
    - `workflowId` string
    - `workflowVersion` integer
  - `message` string
  - `requestId` string

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/b3-fun/apis/b3os-workflow-api.md) · [All operations](https://skmtc.net/b3-fun/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b3-fun/b3os-workflow-api/versions/5a750a5a9596/schema)