Runs
Get run info by id
Get run information (task run, workflow run)
get/v1/runs/{run_id}
Path parameters
run_idstring required
The id of the task run or the workflow run.
Example:tsk_123
The id of the task run or the workflow run.
Headers
x-api-keystring nullable
Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.
Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.
Response
Successfully got run
Example response
{
"run_id": "tsk_123",
"created_at": "2025-01-01T00:00:00Z",
"modified_at": "2025-01-01T00:05:00Z",
"app_url": "https://app.skyvern.com/tasks/tsk_123",
"browser_session_id": "pbs_123",
"browser_profile_id": "bp_123",
"run_request": {
"prompt": "Find the top 3 posts on Hacker News.",
"url": "https://www.hackernews.com",
"title": "The title of my first skyvern task",
"proxy_location": {
"country": "US",
"subdivision": "CA",
"city": "New York"
},
"error_code_mapping": {
"login_failed": "The login credentials are incorrect or the account is locked"
},
"max_steps": 10,
"webhook_url": "https://my-site.com/webhook",
"totp_identifier": "john.doe@example.com",
"totp_url": "https://my-totp-service.com/totp",
"browser_session_id": "pbs_123",
"browser_address": "http://127.0.0.1:9222",
"run_with": "agent"
}
}