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

# Get workflow trace log data (latest run)

> Returns trace data for the latest run of the given workflow. If trace is stored remotely (S3), fetches and returns the data inline. If trace is local only, returns the local path. To pin a specific run, use `/workflow/{id}/runs/{rid}/trace-log`.



## OpenAPI

````yaml /openapi.json get /workflow/{id}/trace-log
openapi: 3.0.0
info:
  title: Output.ai API
  version: 1.0.0
  description: API for managing and executing Output.ai workflows
servers:
  - url: http://localhost:3001
    description: Development server
security: []
tags: []
paths:
  /workflow/{id}/trace-log:
    get:
      summary: Get workflow trace log data (latest run)
      description: >-
        Returns trace data for the latest run of the given workflow. If trace is
        stored remotely (S3), fetches and returns the data inline. If trace is
        local only, returns the local path. To pin a specific run, use
        `/workflow/{id}/runs/{rid}/trace-log`.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: The id of workflow to retrieve trace log
      responses:
        '200':
          description: The trace log response
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/TraceLogRemoteResponse'
                  - $ref: '#/components/schemas/TraceLogLocalResponse'
        '404':
          $ref: '#/components/responses/NotFound'
        '424':
          $ref: '#/components/responses/FailedDependency'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    TraceLogRemoteResponse:
      type: object
      required:
        - source
        - runId
        - data
      properties:
        source:
          type: string
          enum:
            - remote
          description: Indicates trace was fetched from remote storage
        runId:
          type: string
          description: The specific run id this trace belongs to
        data:
          $ref: '#/components/schemas/TraceData'
    TraceLogLocalResponse:
      type: object
      required:
        - source
        - runId
        - localPath
      properties:
        source:
          type: string
          enum:
            - local
          description: Indicates trace is available locally
        runId:
          type: string
          description: The specific run id this trace belongs to
        localPath:
          type: string
          description: Absolute path to local trace file
    TraceData:
      type: object
      description: Trace data containing workflow execution details
      additionalProperties: true
      properties:
        workflowId:
          type: string
          description: The workflow execution ID
        input:
          type: object
          description: The workflow input
        output:
          type: object
          description: The workflow output
        steps:
          type: array
          description: The workflow execution steps
          items:
            type: object
    ErrorResponse:
      type: object
      description: >-
        API error body (WorkflowNotFoundError, UnsupportedWorkflowError,
        WorkflowExecutionTimedOutError, WorkflowNotCompletedError,
        CatalogNotAvailableError, or server error)
      properties:
        error:
          type: string
          description: >-
            Error type name (e.g. WorkflowNotFoundError,
            UnsupportedWorkflowError, CatalogNotAvailableError)
        message:
          type: string
          description: Human-readable error message
        workflowId:
          type: string
          description: >-
            Workflow ID when the error is tied to a specific execution (e.g.
            timeout)
          nullable: true
  responses:
    NotFound:
      description: Workflow execution, workflow type, or catalog not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    FailedDependency:
      description: >-
        Workflow dependency failed (e.g. workflow not in a terminal state, or
        workflow type is unsupported by the selected catalog)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error (e.g. Temporal connection failure)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````