> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowra.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get workflow execution detail

> Returns full details of a single run: inputs, outputs, steps executed, status, and any errors. Use to debug or inspect a specific execution.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/workflow/manager/executions/{id}
openapi: 3.0.0
info:
  title: Flowra API (API Key Endpoints)
  description: >-
    **Flowra** is an AI-powered platform for building agents, workflows, and
    integrations.


    ### Capabilities

    - **Tools & Toolkits** – Define and group tools for agents and workflows.

    - **Workflows** – Orchestrate steps and automate processes.

    - **Triggers** – Schedule or event-based execution.

    - **Auth & Connections** – OAuth, API keys, and connected accounts.

    - **MCP** – Model Context Protocol server integration.

    - **Knowledge / RAG** – Add files and URLs for retrieval-augmented
    generation.


    ### Authentication

    Use the **x-api-key** header with a project API key to access endpoints that
    support API Key auth. Create and manage API keys in the dashboard under your
    project settings.


    Only endpoints that support API Key authentication via the @ApiKeyEnabled()
    decorator.


    Send x-api-key (required). On multi-tenant endpoints, optionally send
    x-username to act as an external user.
  version: '1.0'
  contact:
    name: Flowra
    url: https://flowra.dev
servers:
  - url: https://flowra.dev
    description: Flowra API
security: []
tags:
  - name: Users
    description: User profile
  - name: External Users
    description: End-user identities inside a project (x-username)
  - name: Auth Configs
    description: OAuth and API key configs for toolkits
  - name: Connected Accounts
    description: OAuth connected accounts and link creation
  - name: Toolkits
    description: List and search toolkits
  - name: Tools
    description: List, execute, and manage tools
  - name: Skills
    description: Browse, create, import, and install skills
  - name: Workflow & Agent
    description: Create, run, and inspect workflows and agents
  - name: Triggers
    description: Schedule and event-based trigger instances
  - name: Chat
    description: Threads and streaming agent runs
  - name: File
    description: Upload, list, and download files
  - name: Knowledge
    description: RAG knowledge collections
  - name: Table
    description: Collections and documents
  - name: Sandbox
    description: Ephemeral and durable code sandboxes
  - name: Browser
    description: Live browser sessions and view
  - name: LLM
    description: List AI models and generate completions
  - name: MCP
    description: MCP server management
  - name: usage
    description: Credit balance and usage ledger for the project API key
paths:
  /api/v1/workflow/manager/executions/{id}:
    get:
      tags:
        - Workflow & Agent
      summary: Get workflow execution detail
      description: >-
        Returns full details of a single run: inputs, outputs, steps executed,
        status, and any errors. Use to debug or inspect a specific execution.
      operationId: WorkflowManagerController_getExecutionDetail
      parameters:
        - name: id
          required: true
          in: path
          description: Execution ID
          schema:
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
            type: string
        - name: x-username
          in: header
          required: false
          description: >-
            External user (end user) to act as. Optional — if omitted, Flowra
            uses the project’s default external user. Send a stable username
            (e.g. customer_alice) only when you need another end-user context.
          schema:
            type: string
            default: (project default user)
          example: customer_alice
      responses:
        '200':
          description: Workflow execution detail retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowExecutionDetailDtoSuccessResponse'
              example:
                success: true
                message: Operation completed successfully
                data:
                  id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                  workflowId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                  workflowName: Support bot
                  projectId: ''
                  eUID: ''
                  isOwnExecution: true
                  userId: ''
                  threadId: b737d8af-a9e0-4251-9714-3fdc1126e5fb
                  assistantId: ''
                  inputData:
                    message: hi
                  outputData: {}
                  status: completed
                  currentNodeId: ''
                  executionSummary:
                    completedNodes:
                      - ''
                    failedNodes:
                      - ''
                    errors:
                      - nodeId: ''
                        nodeType: ''
                        error: ''
                        step: ''
                    totalNodes: 0
                  executionMode: production
                  workflowType: agent
                  startedAt: '2026-09-03T10:00:00.000Z'
                  completedAt: '2024-01-01T00:00:00.000Z'
                  executionDurationMs: 1820
                  usage:
                    credits: 0
                    usdCost: 0
                    breakdown:
                      ai_model: 0
                      tool: 0
                      sandbox: 0
                      browser: 0
                      workflow: 0
                      media: 0
                  state: {}
      security:
        - x-api-key: []
        - x-api-key: []
          x-username: []
components:
  schemas:
    WorkflowExecutionDetailDtoSuccessResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Success status
          example: true
        message:
          type: string
          description: Success message
          example: Operation completed successfully
        data:
          type: object
          properties:
            id:
              type: string
              description: Execution ID
              example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
            workflowId:
              type: string
              description: Workflow (agent) ID
              example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
            workflowName:
              type: string
              description: Workflow display name
              example: Support bot
            projectId:
              type: string
              nullable: true
              description: Project ID
            eUID:
              type: string
              nullable: true
              description: External user id (eUID) that triggered this execution
            isOwnExecution:
              type: boolean
              description: >-
                True when execution.eUID matches the requesting user session
                eUID (viewer ran it themselves)
            userId:
              type: string
              description: Dashboard user who started the run
            threadId:
              type: string
              nullable: true
              description: LangGraph thread ID for status polling and resume
              example: b737d8af-a9e0-4251-9714-3fdc1126e5fb
            assistantId:
              type: string
              nullable: true
              description: Assistant / graph id
            inputData:
              type: object
              nullable: true
              description: Input payload sent to EXECUTE
              example:
                message: hi
            outputData:
              type: object
              nullable: true
              description: Final output when the run completed
            status:
              type: string
              enum:
                - running
                - paused
                - completed
                - failed
                - timeout
              description: '`paused` means wait for RESUME with this threadId'
              example: completed
            currentNodeId:
              type: string
              nullable: true
              description: Current static-graph node id while running
            executionSummary:
              type: object
              properties:
                completedNodes:
                  type: array
                  items:
                    type: string
                failedNodes:
                  type: array
                  items:
                    type: string
                errors:
                  type: array
                  items:
                    type: object
                    properties:
                      nodeId:
                        type: string
                      nodeType:
                        type: string
                      error:
                        type: string
                      step:
                        type: string
                    required:
                      - nodeId
                      - nodeType
                      - error
                totalNodes:
                  type: number
              required:
                - completedNodes
                - failedNodes
                - errors
                - totalNodes
            executionMode:
              type: string
              enum:
                - test
                - production
              description: '`test` is a mock run; omit or `production` for live'
              example: production
            workflowType:
              type: string
              enum:
                - agent
                - static
              description: Workflow type (from workflow)
            startedAt:
              format: date-time
              type: string
              description: When the run started
              example: '2026-09-03T10:00:00.000Z'
            completedAt:
              format: date-time
              type: string
              nullable: true
              description: When the run finished (null while running/paused)
            executionDurationMs:
              type: number
              nullable: true
              description: Wall-clock duration in milliseconds
              example: 1820
            usage:
              type: object
              properties:
                credits:
                  type: number
                  description: Net credits consumed for this execution/run
                usdCost:
                  type: number
                  nullable: true
                  description: USD charged to the account for this usage
                breakdown:
                  type: object
                  properties:
                    ai_model:
                      type: number
                      default: 0
                    tool:
                      type: number
                      default: 0
                    sandbox:
                      type: number
                      default: 0
                    browser:
                      type: number
                      default: 0
                    workflow:
                      type: number
                      default: 0
                    media:
                      type: number
                      default: 0
                  required:
                    - ai_model
                    - tool
                    - sandbox
                    - browser
                    - workflow
                    - media
              required:
                - credits
                - usdCost
                - breakdown
              description: Credit usage for this execution when available
            state:
              type: object
              description: Current workflow execution state
          required:
            - id
            - workflowId
            - isOwnExecution
            - status
            - executionMode
            - startedAt
          example:
            id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
            workflowId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
            workflowName: Support bot
            projectId: ''
            eUID: ''
            isOwnExecution: true
            userId: ''
            threadId: b737d8af-a9e0-4251-9714-3fdc1126e5fb
            assistantId: ''
            inputData:
              message: hi
            outputData: {}
            status: completed
            currentNodeId: ''
            executionSummary:
              completedNodes:
                - ''
              failedNodes:
                - ''
              errors:
                - nodeId: ''
                  nodeType: ''
                  error: ''
                  step: ''
              totalNodes: 0
            executionMode: production
            workflowType: agent
            startedAt: '2026-09-03T10:00:00.000Z'
            completedAt: '2024-01-01T00:00:00.000Z'
            executionDurationMs: 1820
            usage:
              credits: 0
              usdCost: 0
              breakdown:
                ai_model: 0
                tool: 0
                sandbox: 0
                browser: 0
                workflow: 0
                media: 0
            state: {}
      required:
        - success
        - message
        - data
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Project API key. Create and manage keys in the dashboard under Project →
        API Keys. Send as header: x-api-key: <your-key>
    x-username:
      type: apiKey
      in: header
      name: x-username
      description: >-
        Optional. External user username. If omitted, Flowra uses the project’s
        default external user. Send as header: x-username: <username>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.