List Project Runs
currents.list_project_runs
ActionBusiness appsconnection required
Calls the Currents API with the connection's credentials.
List a project's recent test runs, filtered by branch, tag or status.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Currents
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- project_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
10 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
project_id Currents project to act on; overrides the default project on the connection. | string | No | — | — | abc123 |
limit How many rows to return in this cursor page; Currents allows 1 to 50. | number | No | 10 | 1–50 | — |
starting_after Cursor of the last row of the previous page; returns the rows older than it. | string | No | — | — | Y3Vyc29yOjEyMw |
tags Only return runs carrying these tags, as a JSON array or a comma-separated list. | array | No | — | array of string | ["smoke"] |
branches Only return runs from these git branches, as a JSON array or a comma-separated list. | array | No | — | array of string | ["main"] |
status Only return runs with this verdict. | string | No | — | one of "PASSED", "FAILED", "RUNNING", "FAILING" | — |
completion_state Only return runs in this completion state. | string | No | — | one of "COMPLETE", "IN_PROGRESS", "CANCELED", "TIMEOUT" | — |
date_start Only return runs started on or after this ISO-8601 timestamp. | string | No | — | iso8601 format | 2026-01-01T00:00:00Z |
date_end Only return runs started on or before this ISO-8601 timestamp. | string | No | — | iso8601 format | 2026-01-31T23:59:59Z |
search Free-text search across the run's commit message, branch and author. | string | No | — | ≤ 200 characters | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"branches": [
"main"
],
"date_end": "2026-01-31T23:59:59Z",
"date_start": "2026-01-01T00:00:00Z",
"limit": 10,
"project_id": "abc123",
"starting_after": "Y3Vyc29yOjEyMw",
"tags": [
"smoke"
]
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
runs The runs on this cursor page, newest first. | array | — |
count How many runs the page carried. | number | — |
has_more True when a further page is available. | boolean | — |
{
"count": 0,
"has_more": false,
"runs": []
}Related Currents nodes
See List Project Runs run in a workflow.
In a technical demo we add the Currents connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.