List workflow runs

Returns a paginated list of the workflow runs in a project, newest first. Use it to find runs again, for example the ones still in_progress. Without date filters, it lists the runs of the last 90 days. Runs are listed without their steps: get a run to see its steps and the tasks each step created

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^\d+$

Numeric ID of the team that owns the project

string
required
^[0-9a-z]+\.[0-9]+$

ID of the project, e.g. 98616399660d3c2456abc5.66984240

Query Params
integer
1 to 100
Defaults to 10

Maximum number of runs to return per page

uuid
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Pagination cursor to fetch the next page; use the meta.cursor from the previous response

filter-workflow-ids
array of uuids
length between 1 and 100

Return only runs of these workflows

filter-workflow-ids
filter-statuses
array of strings
length between 1 and 3

Return only runs in these statuses

filter-statuses
Allowed:

Run status. A run stays in_progress until it completes or fails

filter-target-language-ids
array of strings
length between 1 and 100

Return only runs that translate into at least one of these languages

filter-target-language-ids
date-time
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$

Return only runs started at or after this time. Defaults to 90 days before filter-created-before, or before now

date-time
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$

Return only runs started before this time

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json