> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a workflow run > Returns a single workflow run with its per-step execution results and the executed `graph`, whose nodes are enriched with status, output and error. ## OpenAPI ````yaml GET /workflow/runs/{id} openapi: 3.0.1 info: title: Tela API license: name: MIT version: 1.0.0 servers: - url: https://api.tela.com security: [] paths: /workflow/runs/{id}: get: tags: - Workflow Run summary: Get a workflow run description: > Returns a single workflow run with its per-step execution results and the executed `graph`, whose nodes are enriched with status, output and error. Map-step iterations are aggregated into the node's `runs` array. The `id` may be either the run's internal id or the `externalExecutionId` returned when the run was started through the public API; the response `id` is the external id when one exists. parameters: - name: id in: path required: true description: Workflow run id or external execution id. schema: type: string responses: '200': description: The workflow run with its executed graph. content: application/json: schema: $ref: '#/components/schemas/WorkflowRunDetailResponse' '400': description: The run has no stored graph. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid credentials, or no access to the run's project. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- The project exists in the workspace but the caller's team has no access to it. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Workflow run not found. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: WorkflowRunDetailResponse: allOf: - $ref: '#/components/schemas/WorkflowRunResponse' - type: object properties: graph: $ref: '#/components/schemas/WorkflowRunGraph' required: - graph example: id: exec_01J9Z8Q4M6N2P8R1S3T5V7W9X promptVersionId: 9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f environment: api status: completed startedAt: '2026-09-01T12:00:00.000Z' completedAt: '2026-09-01T12:00:08.412Z' input: invoice: name: invoice type: file required: true files: - fileUrl: vault://files/invoice-0001.pdf name: invoice-0001.pdf mimeType: application/pdf steps: - id: extract name: Extract fields actionId: llm-completion status: completed input: canvasId: 5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12 output: total: 1250.5 error: null output: id: extract name: Extract fields status: completed output: total: 1250.5 error: null metadata: {} graph: nodes: - id: extract name: Extract fields actionId: llm-completion ports: - id: in dir: in type: flow - id: out dir: out type: flow status: completed output: total: 1250.5 error: null edges: [] Error: {} WorkflowRunResponse: type: object properties: id: type: string description: >- External execution id when the run was started through the public API, otherwise the internal run id. promptVersionId: type: string format: uuid environment: type: string enum: - test-case - craft-preview - api - workstation description: Surface that started the run. status: $ref: '#/components/schemas/WorkflowRunStatus' startedAt: type: string format: date-time completedAt: type: string format: date-time nullable: true input: type: object description: Runtime variables the run was started with, keyed by variable name. additionalProperties: true steps: type: array description: >- Visible steps in topological order. Steps on unselected condition branches or outside a partial run's start/end range are reported as `skipped`. items: $ref: '#/components/schemas/WorkflowRunStep' output: nullable: true allOf: - $ref: '#/components/schemas/WorkflowRunOutput' required: - id - promptVersionId - status - startedAt - completedAt - input - steps example: id: exec_01J9Z8Q4M6N2P8R1S3T5V7W9X promptVersionId: 9d2e4f6a-1b3c-4d5e-8f70-1a2b3c4d5e6f environment: api status: completed startedAt: '2026-09-01T12:00:00.000Z' completedAt: '2026-09-01T12:00:08.412Z' input: invoice: name: invoice type: file required: true files: - fileUrl: vault://files/invoice-0001.pdf name: invoice-0001.pdf mimeType: application/pdf steps: - id: extract name: Extract fields actionId: llm-completion status: completed input: canvasId: 5f0c1a2e-8b7d-4c3a-9e1f-2d4b6a8c0e12 output: total: 1250.5 error: null metadata: usage: inputTokens: 812 outputTokens: 24 output: id: extract name: Extract fields status: completed output: total: 1250.5 error: null metadata: {} WorkflowRunGraph: type: object properties: nodes: type: array items: $ref: '#/components/schemas/WorkflowRunNode' edges: type: array items: $ref: '#/components/schemas/WorkflowRunEdge' required: - nodes - edges WorkflowRunStatus: type: string description: > Lifecycle status of a workflow run. Terminal statuses are `completed`, `cancelled`, `failed` and `timeout`. `requires-action` and `waiting-for-review` are active states where the run is paused for external input. enum: - pending - running - completed - failed - requires-action - cancelled - timeout - waiting-for-review WorkflowRunStep: type: object properties: id: type: string description: Node id in the workflow graph. name: type: string actionId: type: string description: Identifier of the action executed by this step. status: $ref: '#/components/schemas/WorkflowRunStepStatus' input: type: object nullable: true additionalProperties: true output: description: Step output. `null` when the step failed or produced nothing yet. nullable: true error: type: string nullable: true metadata: type: object additionalProperties: true steps: type: array description: Nested steps, when present. items: type: object additionalProperties: true required: - id - name - actionId - status - input - output WorkflowRunOutput: type: object description: >- The completed leaf step whose output is the run's result. `null` while no leaf step has completed. properties: id: type: string name: type: string status: $ref: '#/components/schemas/WorkflowRunStepStatus' output: nullable: true error: type: string nullable: true metadata: type: object additionalProperties: true description: >- May include `outputFormatMismatch: true` when an LLM step could not honour its output schema. required: - id - name - status - output WorkflowRunNode: type: object description: >- A graph node enriched with execution data. Additional node properties from the stored graph (for example `input`, `stepNumber`) are passed through. additionalProperties: true properties: id: type: string name: type: string actionId: type: string ports: type: array items: $ref: '#/components/schemas/WorkflowRunPort' status: $ref: '#/components/schemas/WorkflowRunStepStatus' output: nullable: true description: >- For nodes inside a map sub-graph this is an array with one entry per iteration. error: nullable: true metadata: type: object additionalProperties: true runs: type: array description: Per-iteration results for nodes executed inside a map step. items: $ref: '#/components/schemas/WorkflowRunChildResult' required: - id - name - actionId - ports - status - output - error WorkflowRunEdge: type: object properties: id: type: string source: type: object properties: id: type: string portId: type: string required: - id - portId target: type: object properties: id: type: string portId: type: string required: - id - portId required: - id - source - target WorkflowRunStepStatus: type: string enum: - pending - running - completed - failed - skipped - cancelled - waiting - aborted WorkflowRunPort: type: object properties: id: type: string dir: type: string enum: - in - out type: type: string required: - id - dir - type WorkflowRunChildResult: type: object description: Result of one iteration of a map step's sub-run. properties: index: type: integer status: $ref: '#/components/schemas/WorkflowRunStepStatus' output: nullable: true error: nullable: true metadata: type: object additionalProperties: true required: - index - status - output - error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT or UUID ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.