Get all runs by agent
List runs for a specific workflow.
Supports filtering by status, search_key, and error_code. All filters are combined with AND logic.
search_key
Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. Soft-deleted parameter definitions are excluded.
error_code
Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code.
include_child_runs
Child runs — runs this workflow started from inside another workflow run — are excluded by default, so the history shows only top-level runs. Pass include_child_runs=true to list them as well; every run carries a parent_workflow_run_id that is null for top-level runs.
Path parameters
Query parameters
Page number for pagination.
Page number for pagination.
Number of runs to return per page.
Number of runs to return per page.
Filter by one or more run statuses.
Filter by one or more run statuses.
Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.
Case-insensitive substring search across: workflow run ID, parameter key, parameter description, run parameter value, and extra HTTP headers. A run is returned if any of these fields match. Soft-deleted parameter definitions are excluded from key/description matching.
Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.
Exact-match filter on the error_code field inside each task's errors JSON array. A run matches if any of its tasks contains an error with a matching error_code. Error codes are user-defined strings set during workflow execution.
Only include runs created at or after this UTC timestamp (ISO 8601).
Only include runs created at or after this UTC timestamp (ISO 8601).
Only include runs created strictly before this UTC timestamp (ISO 8601).
Only include runs created strictly before this UTC timestamp (ISO 8601).
Filter by run tags. Each term is a label (production), a group (env:*), or a group:label (env:prod). Repeat the param or comma-separate (?tags=env:prod,env:staging). AND across distinct terms, OR within a group's labels (?tags=customer:acme,env:prod,env:staging -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only.
Filter by run tags. Each term is a label (production), a group (env:*), or a group:label (env:prod). Repeat the param or comma-separate (?tags=env:prod,env:staging). AND across distinct terms, OR within a group's labels (?tags=customer:acme,env:prod,env:staging -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only.
Include child workflow runs — runs started from inside another workflow run. Excluded by default so the history shows only top-level runs.
Include child workflow runs — runs started from inside another workflow run. Excluded by default so the history shows only top-level runs.
Headers
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
Successful Response
Example response
[
{
"proxy_location": {
"country": "US",
"subdivision": "CA",
"city": "New York"
}
}
]