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

200Retrieved

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

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