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

# Get run timeline

> Get timeline for a run (workflow run or task_v2 run)



## OpenAPI

````yaml /api-reference/openapi.json get /v1/runs/{run_id}/timeline
openapi: 3.1.0
info:
  title: Skyvern API
  description: API for Skyvern
  version: 1.0.0
servers:
  - url: https://api.skyvern.com
    x-fern-server-name: Cloud
  - url: https://api-staging.skyvern.com
    x-fern-server-name: Staging
  - url: http://localhost:8000
    x-fern-server-name: Local
security: []
paths:
  /v1/runs/{run_id}/timeline:
    get:
      tags:
        - Runs
      summary: Get run timeline
      description: Get timeline for a run (workflow run or task_v2 run)
      operationId: get_run_timeline_v1_runs__run_id__timeline_get
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            description: The id of the workflow run or task_v2 run.
            examples:
              - wr_123
              - tsk_v2_123
            title: Run Id
          description: The id of the workflow run or task_v2 run.
        - name: x-api-key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Skyvern API key for authentication. API key can be found at
              https://app.skyvern.com/settings.
            title: X-Api-Key
          description: >-
            Skyvern API key for authentication. API key can be found at
            https://app.skyvern.com/settings.
      responses:
        '200':
          description: Successfully retrieved run timeline
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WorkflowRunTimeline'
                title: Response Get Run Timeline V1 Runs  Run Id  Timeline Get
        '400':
          description: Timeline not available for this run type
        '404':
          description: Run not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    WorkflowRunTimeline:
      properties:
        type:
          $ref: '#/components/schemas/WorkflowRunTimelineType'
        block:
          anyOf:
            - $ref: '#/components/schemas/WorkflowRunBlock'
            - type: 'null'
        thought:
          anyOf:
            - $ref: '#/components/schemas/Thought'
            - type: 'null'
        children:
          items:
            $ref: '#/components/schemas/WorkflowRunTimeline'
          type: array
          title: Children
          default: []
        created_at:
          type: string
          format: date-time
          title: Created At
        modified_at:
          type: string
          format: date-time
          title: Modified At
      type: object
      required:
        - type
        - created_at
        - modified_at
      title: WorkflowRunTimeline
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkflowRunTimelineType:
      type: string
      enum:
        - thought
        - block
      title: WorkflowRunTimelineType
    WorkflowRunBlock:
      properties:
        workflow_run_block_id:
          type: string
          title: Workflow Run Block Id
        block_workflow_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Block Workflow Run Id
        workflow_run_id:
          type: string
          title: Workflow Run Id
        organization_id:
          type: string
          title: Organization Id
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        parent_workflow_run_block_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent Workflow Run Block Id
        block_type:
          $ref: '#/components/schemas/BlockType'
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
        output:
          anyOf:
            - additionalProperties: true
              type: object
            - items: {}
              type: array
            - type: string
            - type: 'null'
          title: Output
        continue_on_failure:
          type: boolean
          title: Continue On Failure
          default: false
        failure_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Failure Reason
        error_codes:
          items:
            type: string
          type: array
          title: Error Codes
          default: []
        engine:
          anyOf:
            - $ref: '#/components/schemas/RunEngine'
            - type: 'null'
        task_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Task Id
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        navigation_goal:
          anyOf:
            - type: string
            - type: 'null'
          title: Navigation Goal
        navigation_payload:
          anyOf:
            - additionalProperties: true
              type: object
            - items: {}
              type: array
            - type: string
            - type: 'null'
          title: Navigation Payload
        data_extraction_goal:
          anyOf:
            - type: string
            - type: 'null'
          title: Data Extraction Goal
        data_schema:
          anyOf:
            - additionalProperties: true
              type: object
            - items: {}
              type: array
            - type: string
            - type: 'null'
          title: Data Schema
        terminate_criterion:
          anyOf:
            - type: string
            - type: 'null'
          title: Terminate Criterion
        complete_criterion:
          anyOf:
            - type: string
            - type: 'null'
          title: Complete Criterion
        actions:
          items:
            $ref: '#/components/schemas/Action'
          type: array
          title: Actions
          default: []
        created_at:
          type: string
          format: date-time
          title: Created At
        modified_at:
          type: string
          format: date-time
          title: Modified At
        include_action_history_in_verification:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Include Action History In Verification
          default: false
        include_extracted_text:
          type: boolean
          title: Include Extracted Text
          default: true
        duration:
          anyOf:
            - type: number
            - type: 'null'
          title: Duration
        loop_values:
          anyOf:
            - items: {}
              type: array
            - type: 'null'
          title: Loop Values
        current_value:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Value
        current_index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Current Index
        recipients:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Recipients
        attachments:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Attachments
        subject:
          anyOf:
            - type: string
            - type: 'null'
          title: Subject
        body:
          anyOf:
            - type: string
            - type: 'null'
          title: Body
        instructions:
          anyOf:
            - type: string
            - type: 'null'
          title: Instructions
        positive_descriptor:
          anyOf:
            - type: string
            - type: 'null'
          title: Positive Descriptor
        negative_descriptor:
          anyOf:
            - type: string
            - type: 'null'
          title: Negative Descriptor
        executed_branch_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Executed Branch Id
        executed_branch_expression:
          anyOf:
            - type: string
            - type: 'null'
          title: Executed Branch Expression
        executed_branch_result:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Executed Branch Result
        executed_branch_next_block:
          anyOf:
            - type: string
            - type: 'null'
          title: Executed Branch Next Block
        script_run:
          anyOf:
            - $ref: '#/components/schemas/ScriptRunResponse'
            - type: 'null'
        downloaded_file_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Downloaded File Count
      type: object
      required:
        - workflow_run_block_id
        - workflow_run_id
        - organization_id
        - block_type
        - created_at
        - modified_at
      title: WorkflowRunBlock
    Thought:
      properties:
        thought_id:
          type: string
          title: Thought Id
        task_id:
          type: string
          title: Task Id
        organization_id:
          type: string
          title: Organization Id
        workflow_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Run Id
        workflow_run_block_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Run Block Id
        workflow_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Id
        workflow_permanent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Permanent Id
        user_input:
          anyOf:
            - type: string
            - type: 'null'
          title: User Input
        observation:
          anyOf:
            - type: string
            - type: 'null'
          title: Observation
        thought:
          anyOf:
            - type: string
            - type: 'null'
          title: Thought
        answer:
          anyOf:
            - type: string
            - type: 'null'
          title: Answer
        thought_type:
          anyOf:
            - $ref: '#/components/schemas/ThoughtType'
            - type: 'null'
          default: plan
        thought_scenario:
          anyOf:
            - $ref: '#/components/schemas/ThoughtScenario'
            - type: 'null'
        output:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Output
        input_token_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Input Token Count
        output_token_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Output Token Count
        reasoning_token_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reasoning Token Count
        cached_token_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Cached Token Count
        thought_cost:
          anyOf:
            - type: number
            - type: 'null'
          title: Thought Cost
        last_llm_model:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Llm Model
        created_at:
          type: string
          format: date-time
          title: Created At
        modified_at:
          type: string
          format: date-time
          title: Modified At
      type: object
      required:
        - thought_id
        - task_id
        - organization_id
        - created_at
        - modified_at
      title: Thought
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    BlockType:
      type: string
      enum:
        - task
        - task_v2
        - for_loop
        - while_loop
        - conditional
        - code
        - text_prompt
        - download_to_s3
        - upload_to_s3
        - file_upload
        - send_email
        - file_url_parser
        - validation
        - action
        - navigation
        - extraction
        - login
        - wait
        - file_download
        - goto_url
        - pdf_parser
        - http_request
        - human_interaction
        - print_page
        - workflow_trigger
        - google_sheets_read
        - google_sheets_write
        - pdf_fill
      title: BlockType
    RunEngine:
      type: string
      enum:
        - skyvern-1.0
        - skyvern-2.0
        - openai-cua
        - anthropic-cua
        - ui-tars
        - yutori-navigator
      title: RunEngine
    Action:
      properties:
        action_type:
          $ref: '#/components/schemas/ActionType'
        status:
          $ref: '#/components/schemas/ActionStatus'
          default: pending
        action_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Action Id
        source_action_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Action Id
        organization_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Organization Id
        workflow_run_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workflow Run Id
        task_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Task Id
        step_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Step Id
        step_order:
          anyOf:
            - type: integer
            - type: 'null'
          title: Step Order
        action_order:
          anyOf:
            - type: integer
            - type: 'null'
          title: Action Order
        confidence_float:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence Float
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        reasoning:
          anyOf:
            - type: string
            - type: 'null'
          title: Reasoning
        intention:
          anyOf:
            - type: string
            - type: 'null'
          title: Intention
        response:
          anyOf:
            - type: string
            - type: 'null'
          title: Response
        element_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Element Id
        skyvern_element_hash:
          anyOf:
            - type: string
            - type: 'null'
          title: Skyvern Element Hash
        skyvern_element_data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Skyvern Element Data
        screenshot_artifact_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Screenshot Artifact Id
        tool_call_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Tool Call Id
        xpath:
          anyOf:
            - type: string
            - type: 'null'
          title: Xpath
        errors:
          anyOf:
            - items:
                $ref: '#/components/schemas/UserDefinedError'
              type: array
            - type: 'null'
          title: Errors
        terminal_user_errors:
          type: boolean
          title: Terminal User Errors
          default: false
        data_extraction_goal:
          anyOf:
            - type: string
            - type: 'null'
          title: Data Extraction Goal
        output:
          anyOf:
            - additionalProperties: true
              type: object
            - items: {}
              type: array
            - type: string
            - type: 'null'
          title: Output
        file_name:
          anyOf:
            - type: string
            - type: 'null'
          title: File Name
        file_url:
          anyOf:
            - type: string
            - type: 'null'
          title: File Url
        download:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Download
        download_triggered:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Download Triggered
        downloaded_files:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Downloaded Files
        is_upload_file_tag:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Upload File Tag
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
        input_or_select_context:
          anyOf:
            - $ref: '#/components/schemas/InputOrSelectContext'
            - type: 'null'
        option:
          anyOf:
            - $ref: '#/components/schemas/SelectOption'
            - type: 'null'
        is_checked:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Checked
        verified:
          type: boolean
          title: Verified
          default: false
        click_context:
          anyOf:
            - $ref: '#/components/schemas/ClickContext'
            - type: 'null'
        totp_timing_info:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Totp Timing Info
        has_mini_agent:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Mini Agent
        skip_auto_complete_tab:
          type: boolean
          title: Skip Auto Complete Tab
          default: false
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        modified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Modified At
        created_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Created By
      type: object
      required:
        - action_type
      title: Action
    ScriptRunResponse:
      properties:
        ai_fallback_triggered:
          type: boolean
          title: Ai Fallback Triggered
          default: false
        script_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Script Id
        script_revision_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Script Revision Id
      type: object
      title: ScriptRunResponse
    ThoughtType:
      type: string
      enum:
        - plan
        - metadata
        - user_goal_check
        - internal_plan
        - failure_describe
        - termination
      title: ThoughtType
      description: >-
        Type of thought recorded during task execution.


        Note: Stored as VARCHAR in the database (not a PostgreSQL ENUM), so new
        values

        can be added without database migrations. See
        observer_thoughts.observer_thought_type column.
    ThoughtScenario:
      type: string
      enum:
        - generate_plan
        - user_goal_check
        - failure_describe
        - summarization
        - generate_metadata
        - extract_loop_values
        - generate_task_in_loop
        - generate_general_task
        - termination
      title: ThoughtScenario
      description: >-
        Scenario in which a thought was generated.


        Note: Stored as VARCHAR in the database (not a PostgreSQL ENUM), so new
        values

        can be added without database migrations. See
        observer_thoughts.observer_thought_scenario column.
    ActionType:
      type: string
      enum:
        - click
        - input_text
        - upload_file
        - download_file
        - select_option
        - checkbox
        - wait
        - hover
        - null_action
        - solve_captcha
        - terminate
        - complete
        - reload_page
        - close_page
        - new_tab
        - switch_tab
        - extract
        - verification_code
        - goto_url
        - go_back
        - go_forward
        - scroll
        - keypress
        - move
        - drag
        - left_mouse
        - execute_js
      title: ActionType
    ActionStatus:
      type: string
      enum:
        - pending
        - skipped
        - failed
        - completed
      title: ActionStatus
    UserDefinedError:
      properties:
        error_code:
          type: string
          title: Error Code
        reasoning:
          type: string
          title: Reasoning
        confidence_float:
          type: number
          maximum: 1
          minimum: 0
          title: Confidence Float
        error_type:
          type: string
          const: USER_DEFINED_ERROR
          title: Error Type
          default: USER_DEFINED_ERROR
      type: object
      required:
        - error_code
        - reasoning
        - confidence_float
      title: UserDefinedError
    InputOrSelectContext:
      properties:
        intention:
          anyOf:
            - type: string
            - type: 'null'
          title: Intention
        field:
          anyOf:
            - type: string
            - type: 'null'
          title: Field
        is_required:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Required
        is_search_bar:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Search Bar
        is_location_input:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Location Input
        is_date_related:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Date Related
        date_format:
          anyOf:
            - type: string
            - type: 'null'
          title: Date Format
        is_text_captcha:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Text Captcha
      type: object
      title: InputOrSelectContext
    SelectOption:
      properties:
        label:
          anyOf:
            - type: string
            - type: 'null'
          title: Label
        value:
          anyOf:
            - type: string
            - type: 'null'
          title: Value
        index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Index
      type: object
      title: SelectOption
    ClickContext:
      properties:
        thought:
          anyOf:
            - type: string
            - type: 'null'
          title: Thought
        single_option_click:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Single Option Click
      type: object
      title: ClickContext

````