Watch workflow run
watch_workflow_runAfter committing to a repo (github_commit_files returns commit_sha), register a watch on the CI run that commit triggers, then finish your turn — the platform wakes this conversation with the run's conclusion (or a timeout notice). Never busy-poll workflow runs while waiting. Identify the run by head_sha (the commit you just pushed) or an explicit run_id; branch disambiguates head_sha lookups.
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": {
"owner": "<owner>",
"repo": "<repo>"
},
"name": "watch_workflow_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo | Yes | Repository name. | |
| owner | Yes | Repository owner (organisation or user). | |
| branch | No | Branch name to disambiguate head_sha lookups. | |
| run_id | No | Explicit workflow run id to watch; alternative to head_sha. | |
| head_sha | No | Commit SHA whose workflow run to watch (e.g. the commit_sha returned by github_commit_files). One of head_sha/run_id is required. | |
| timeout_minutes | No | Minutes to keep watching before the platform reports a timeout instead (default 30, max 60). |