List Runs

GET/api/v1/workflow/{workflow_id}/runs

Get workflow runs with optional filtering and sorting. Filters should be provided as a JSON-encoded array of filter criteria. Example: [{"attribute": "dateRange", "value": {"from": "2024-01-01", "to": "2024-01-31"}}]

cURL example

curl -X GET \
  'http://localhost:8000/api/v1/workflow/{workflow_id}/runs' \
  -H 'Authorization: Bearer <API_KEY>'

Parameters

Name	Location	Type	Description
`workflow_id`required	path	integer	—
`page`	query	integer	Page number (starts from 1)
`limit`	query	integer	Number of items per page
`filters`	query	object	JSON-encoded filter criteria
`sort_by`	query	object	Field to sort by (e.g., 'duration', 'created_at')
`sort_order`	query	object	Sort order ('asc' or 'desc')
`authorization`	header	object	—
`X-API-Key`	header	object	—

Responses

200Successful Response

application/json

View schema

{
  "$ref": "#/components/schemas/WorkflowRunsResponse"
}

404Not found

422Validation Error

application/json

View schema

{
  "$ref": "#/components/schemas/HTTPValidationError"
}