List Executions
rundeck.list_executions
ActionBusiness appsconnection required
Calls the Rundeck API with the connection's credentials.
Query a project's executions by status, job or recency.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Rundeck
- Secret shape
- the API token, or {"api_token": "…"}
- Config it needs
- base_url, api_version, project
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 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 The Rundeck project to act on; leave blank to use the connection's project. | string | No | — | — | acme-platform |
status_filter Return only executions in this state. | string | No | — | one of "running", "succeeded", "failed", "aborted" | — |
job_id_list_filter Return only executions of these job UUIDs, comma-separated. | string | No | — | — | 3940e6ab-1b1c-4a0e-9e5f-0f2a1c9f0001 |
recent_filter Return only executions completed within this period, written as a number and a unit such as 2d, 6h or 1w. | string | No | — | — | 2d |
max_results How many executions to return in one page; Rundeck's own default is 20. | number | No | 20 | ≥ 1 | — |
offset Skip this many executions before the page starts. | number | No | — | ≥ 0 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"job_id_list_filter": "3940e6ab-1b1c-4a0e-9e5f-0f2a1c9f0001",
"max_results": 20,
"project": "acme-platform",
"recent_filter": "2d"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
executions One entry per execution the query matched. | array | — |
executions[].id The execution id. | number | — |
executions[].status The execution's status. | string | — |
executions[].project The project it belongs to. | string | — |
executions[].user The user it ran as. | string | — |
executions[].permalink The Rundeck web URL for the execution. | string | — |
executions[].date-started When it started. | any | — |
executions[].job The job that was run, when there was one. | object | — |
count How many executions this page carried. | number | — |
paging Rundeck's paging block: offset, max, total and count. | object | — |
project The project the query ran against. | string | — |
{
"count": 0,
"executions": [
{
"date-started": null,
"id": 0,
"job": {},
"permalink": "",
"project": "",
"status": "",
"user": ""
}
],
"paging": {},
"project": ""
}See List Executions run in a workflow.
In a technical demo we add the Rundeck connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.