list_workflow_runs
Retrieve and filter workflow runs for a GitHub repository by owner, repo, workflow ID, actor, branch, event, status, or creation date. Supports pagination and excluding PR-triggered runs.
Instructions
List all workflow runs for a repository or specific workflow
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | No | Filter by user who triggered the workflow | |
| branch | No | Filter by branch | |
| checkSuiteId | No | Filter by check suite ID | |
| created | No | Filter by creation date (YYYY-MM-DD) | |
| event | No | Filter by event type | |
| excludePullRequests | No | Exclude PR-triggered runs | |
| owner | Yes | Repository owner | |
| page | No | Page number for pagination | |
| perPage | No | Results per page (max 100) | |
| repo | Yes | Repository name | |
| status | No | Filter by status | |
| workflowId | No | The ID of the workflow or filename |
Input Schema (JSON Schema)
{
"properties": {
"actor": {
"description": "Filter by user who triggered the workflow",
"type": "string"
},
"branch": {
"description": "Filter by branch",
"type": "string"
},
"checkSuiteId": {
"description": "Filter by check suite ID",
"type": "number"
},
"created": {
"description": "Filter by creation date (YYYY-MM-DD)",
"type": "string"
},
"event": {
"description": "Filter by event type",
"type": "string"
},
"excludePullRequests": {
"description": "Exclude PR-triggered runs",
"type": "boolean"
},
"owner": {
"description": "Repository owner",
"type": "string"
},
"page": {
"description": "Page number for pagination",
"type": "number"
},
"perPage": {
"description": "Results per page (max 100)",
"type": "number"
},
"repo": {
"description": "Repository name",
"type": "string"
},
"status": {
"description": "Filter by status",
"enum": [
"completed",
"action_required",
"cancelled",
"failure",
"neutral",
"skipped",
"stale",
"success",
"timed_out",
"in_progress",
"queued",
"requested",
"waiting"
],
"type": "string"
},
"workflowId": {
"description": "The ID of the workflow or filename",
"oneOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"required": [
"owner",
"repo"
],
"type": "object"
}