List Ai Automation Runs
list_ai_automation_runsList recent runs of a specific AI automation with status, trigger type, and timing to review execution history. Read-only, with filters and pagination for scanning older runs.
Instructions
List recent runs of one AI automation with status, trigger and timing. Read-only.
Scans the 1000 most recent runs matching the filters; pagination and counts cover the visible runs in that window. When meta.next_scan_cursor is set, older runs exist beyond the window. Present only on the last page of the current scan window; finish page pagination before following it. Repeat the request with filter[scan_cursor] set to that opaque cursor to continue. Incident-linked runs are visible only when the caller's role permits access. OAuth tokens also need the ir.incidents:read scope; API keys use the key's role. Requires OAuth scope ai.automations:write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ai_automation_id": "<ai_automation_id>"
},
"name": "list_ai_automation_runs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter_status | No | Comma-separated statuses; any matching status is included. | |
| ai_automation_id | Yes | Required. ID of the ai automation (fills `{ai_automation_id}` in /v1/ai/automations/{ai_automation_id}/runs). | |
| filter_scan_cursor | No | Opaque encrypted cursor from meta.next_scan_cursor. | |
| filter_trigger_kind | No | Comma-separated trigger kinds; any matching kind is included. | |
| filter_created_at_gte | No | ||
| filter_created_at_lte | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||