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.
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.
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"
}
}
]