--- title: "Get run timeline" method: GET path: "/v1/runs/{run_id}/timeline" tags: ["Runs"] --- # Get run timeline `GET /v1/runs/{run_id}/timeline` Get timeline for a run (workflow run or task_v2 run) ## Path parameters - `run_id` string, required — The id of the workflow run or task_v2 run. ## Headers - `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings. ## Response `200` Successfully retrieved run timeline - WorkflowRunTimeline[] - `type` 'thought' | 'block', required - `block` WorkflowRunBlock - `workflow_run_block_id` string, required - `block_workflow_run_id` string, nullable - `workflow_run_id` string, required - `organization_id` string, required - `description` string, nullable - `parent_workflow_run_block_id` string, nullable - `block_type` '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' | 'split_pdf' | 'email_inbox', required - `label` string, nullable - `status` string, nullable - `output` union - object - unknown[] - unknown - string - `continue_on_failure` boolean - `failure_reason` string, nullable - `error_codes` string[] - `engine` 'skyvern-1.0' | 'skyvern-2.0' | 'openai-cua' | 'anthropic-cua' | 'ui-tars' | 'yutori-navigator' - `task_id` string, nullable - `url` string, nullable - `final_url` string, nullable - `navigation_goal` string, nullable - `navigation_payload` union - object - unknown[] - unknown - string - `data_extraction_goal` string, nullable - `data_schema` union - object - unknown[] - unknown - string - `terminate_criterion` string, nullable - `complete_criterion` string, nullable - `actions` Action[] - `action_type` 'click' | 'input_text' | 'paste_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', required - `status` 'pending' | 'skipped' | 'failed' | 'completed' - `action_id` string, nullable - `source_action_id` string, nullable - `organization_id` string, nullable - `workflow_run_id` string, nullable - `task_id` string, nullable - `step_id` string, nullable - `step_order` integer, nullable - `action_order` integer, nullable - `confidence_float` number, nullable - `description` string, nullable - `reasoning` string, nullable - `intention` string, nullable - `response` string, nullable - `element_id` string, nullable - `skyvern_element_hash` string, nullable - `skyvern_element_data` object, nullable - `screenshot_artifact_id` string, nullable - `tool_call_id` string, nullable - `xpath` string, nullable - `errors` UserDefinedError[], nullable - `error_code` string, required - `reasoning` string, required - `confidence_float` number, required - `error_type` 'USER_DEFINED_ERROR' - `terminal_user_errors` boolean - `data_extraction_goal` string, nullable - `output` union - object - unknown[] - unknown - string - `file_name` string, nullable - `file_url` string, nullable - `download` boolean, nullable - `download_triggered` boolean, nullable - `downloaded_files` string[], nullable - `is_upload_file_tag` boolean, nullable - `text` string, nullable - `input_or_select_context` InputOrSelectContext - `intention` string, nullable - `field` string, nullable - `is_required` boolean, nullable - `is_search_bar` boolean, nullable - `is_location_input` boolean, nullable - `is_date_related` boolean, nullable - `date_format` string, nullable - `is_text_captcha` boolean, nullable - `option` SelectOption - `label` string, nullable - `value` string, nullable - `index` integer, nullable - `is_checked` boolean, nullable - `verified` boolean - `click_context` ClickContext - `thought` string, nullable - `single_option_click` boolean, nullable - `totp_timing_info` object, nullable - `has_mini_agent` boolean, nullable - `skip_auto_complete_tab` boolean - `started_at` string, date-time, nullable - `finished_at` string, date-time, nullable - `created_at` string, date-time, nullable - `modified_at` string, date-time, nullable - `created_by` string, nullable - `created_at` string, date-time, required - `modified_at` string, date-time, required - `include_action_history_in_verification` boolean, nullable - `include_extracted_text` boolean - `duration` number, nullable - `loop_values` unknown[], nullable - unknown - `current_value` string, nullable - `current_index` integer, nullable - `recipients` string[], nullable - `attachments` string[], nullable - `subject` string, nullable - `body` string, nullable - `prompt` string, nullable - `instructions` string, nullable - `positive_descriptor` string, nullable - `negative_descriptor` string, nullable - `executed_branch_id` string, nullable - `executed_branch_expression` string, nullable - `executed_branch_result` boolean, nullable - `executed_branch_next_block` string, nullable - `script_run` ScriptRunResponse - `ai_fallback_triggered` boolean - `script_id` string, nullable - `script_revision_id` string, nullable - `downloaded_file_count` integer, nullable - `thought` Thought - `thought_id` string, required - `task_id` string, required - `organization_id` string, required - `workflow_run_id` string, nullable - `workflow_run_block_id` string, nullable - `workflow_id` string, nullable - `workflow_permanent_id` string, nullable - `user_input` string, nullable - `observation` string, nullable - `thought` string, nullable - `answer` string, nullable - `thought_type` 'plan' | 'metadata' | 'user_goal_check' | 'internal_plan' | 'failure_describe' | 'termination' — 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. - `thought_scenario` 'generate_plan' | 'user_goal_check' | 'failure_describe' | 'summarization' | 'generate_metadata' | 'extract_loop_values' | 'generate_task_in_loop' | 'generate_general_task' | 'termination' — 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. - `output` object, nullable - `input_token_count` integer, nullable - `output_token_count` integer, nullable - `reasoning_token_count` integer, nullable - `cached_token_count` integer, nullable - `thought_cost` number, nullable - `last_llm_model` string, nullable - `created_at` string, date-time, required - `modified_at` string, date-time, required - `children` WorkflowRunTimeline[] - `created_at` string, date-time, required - `modified_at` string, date-time, required ## Other responses - `400` — Timeline not available for this run type - `404` — Run not found - `422` — Validation Error --- [API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/29562c6e0364/schema)