Get a run by id

GET

/v1/runs/:run_id

GET

/v1/runs/:run_id

1 from skyvern import Skyvern
2 
3 skyvern = Skyvern(api_key="YOUR_API_KEY")
4 run = await skyvern.get_run(run_id="tsk_v2_123")
5 print(run)

Try it

200getRunExample

1 {
2   "run_id": "tsk_123",
3   "status": "created",
4   "output": {},
5   "downloaded_files": [
6     {
7       "url": "foo",
8       "checksum": "foo",
9       "filename": "foo"
10     }
11   ],
12   "recording_url": "foo",
13   "screenshot_urls": [
14     "foo"
15   ],
16   "failure_reason": "foo",
17   "created_at": "2025-01-01T00:00:00Z",
18   "modified_at": "2025-01-01T00:05:00Z",
19   "queued_at": "foo",
20   "started_at": "foo",
21   "finished_at": "foo",
22   "app_url": "foo",
23   "browser_session_id": "foo",
24   "max_screenshot_scrolls": 42,
25   "run_type": "task_v1",
26   "run_request": {
27     "prompt": "Find the top 3 posts on Hacker News.",
28     "url": "foo",
29     "engine": "skyvern-1.0",
30     "title": "foo",
31     "proxy_location": "RESIDENTIAL",
32     "data_extraction_schema": {},
33     "error_code_mapping": {},
34     "max_steps": 42,
35     "webhook_url": "foo",
36     "totp_identifier": "foo",
37     "totp_url": "foo",
38     "browser_session_id": "foo",
39     "model": {},
40     "extra_http_headers": {},
41     "publish_workflow": false,
42     "include_action_history_in_verification": true,
43     "max_screenshot_scrolls": 42
44   }
45 }

Get run information (task run, workflow run)

Path parameters

run_idstringRequired

The id of the task run or the workflow run.

Response

Successfully got run

TaskRunResponseobject

WorkflowRunResponseobject

Get a run by id

Path parameters

Headers

Response

Errors