Skip to main content
Get the step-by-step timeline of a run. Each entry represents one AI action with screenshots and reasoning. 
timeline = await client.get_run_timeline("tsk_v2_486305187432193504")
for step in timeline:
    print(f"Step {step.order}: {step.type} - {step.status}")

​
Parameters

ParameterTypeRequiredDescription
run_idstrYesThe run ID.
request_optionsRequestOptionsNoPer-request configuration (see below).

​
Returns list[WorkflowRunTimeline]

Each timeline entry contains step details including type, status, order, and associated artifacts.

​
Request options

Override timeout, retries, or headers for this call by passing request_options (Python) or a second options argument (TypeScript). 
from skyvern.client.core import RequestOptions

request_options=RequestOptions(
    timeout_in_seconds=120,
    max_retries=3,
    additional_headers={"x-custom-header": "value"},
)
Option (Python)Option (TypeScript)TypeDescription
timeout_in_secondstimeoutInSecondsint / numberHTTP timeout in seconds.
max_retriesmaxRetriesint / numberRetry count.
additional_headersheadersdict / Record<string, string>Extra headers.
additional_query_parameters-dictExtra query parameters.
additional_body_parameters-dictExtra body parameters.
-abortSignalAbortSignalSignal to cancel the request.
-apiKeystringOverride API key.