Watch pipeline run
watch_pipeline_runWait for an Ankra Pipelines run of a connected repository to conclude. Blocks up to 45 seconds and returns the settled run (outcome, each step's outcome, the first failing step) or timed_out true with the last observed state. Nothing notifies this client when a run ends later: on timed_out, call watch_pipeline_run again with the run_id it returned to keep waiting. Identify the run by head_sha (the commit) or run_id (the run's UUID, or its run number in the repository: 3630 for run #3630); branch disambiguates head_sha lookups. provider defaults to github; timeout_minutes is ignored here. Read a failing step's log with get_pipeline_step_logs. The repository must already be connected to Ankra Pipelines.
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_pipeline_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 | Pipeline run to watch, alternative to head_sha: its UUID, or its run number in this repository (3630 for run #3630). | |
| head_sha | No | Commit SHA whose pipeline run to watch. One of head_sha/run_id/pull_request_number is required. | |
| provider | No | Source control provider: github, gitlab, or bitbucket_cloud. Defaults to github. | |
| timeout_minutes | No | Minutes to keep watching before the platform reports a timeout instead (default 30, max 60; for pull_request_number, default 1440, min 30, max 4320). | |
| pull_request_number | No | An open GitHub pull request to wait on until it merges or is closed, instead of head_sha/run_id. |