list-workflow-runs
Retrieve and filter GitHub workflow runs by status, branch, or workflow ID to monitor CI/CD pipeline execution and track build statuses.
Instructions
List workflow runs in a GitHub repository
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| branch | No | Filter by branch name | |
| owner | Yes | Repository owner | |
| page | No | Page number | |
| perPage | No | Items per page | |
| repo | Yes | Repository name | |
| status | No | Filter by run status | |
| workflow_id | No | Workflow ID or file name |
Input Schema (JSON Schema)
{
"properties": {
"branch": {
"description": "Filter by branch name",
"type": "string"
},
"owner": {
"description": "Repository owner",
"type": "string"
},
"page": {
"description": "Page number",
"type": "integer"
},
"perPage": {
"description": "Items per page",
"type": "integer"
},
"repo": {
"description": "Repository name",
"type": "string"
},
"status": {
"description": "Filter by run status",
"enum": [
"completed",
"action_required",
"cancelled",
"failure",
"neutral",
"skipped",
"stale",
"success",
"timed_out",
"in_progress",
"queued",
"requested",
"waiting"
],
"type": "string"
},
"workflow_id": {
"description": "Workflow ID or file name",
"type": [
"string",
"number"
]
}
},
"required": [
"owner",
"repo"
],
"type": "object"
}