Get commit statuses
get_commit_statusesList every status reported against a commit, branch, or tag, including each check’s context, state, and target URL, to inspect CI history; use get_combined_status for a single pass/fail verdict.
Instructions
List the statuses reported against a commit, branch or tag (owner/repo/ref): each check's context, status (success, pending, failure, error, warning), description and target_url. Every transition is recorded, so one ref carries a history rather than a state: the same context appears as 'Waiting to run', then 'In progress', then its result. The newest entry per context is the current verdict — for "did CI pass?" call get_combined_status instead, which returns one state with the latest per check. Neither Forgejo nor Gitea exposes a logs API, so target_url is often the only route to a failing run's detail; both return it relative to the instance origin, so prefix the host before following it. Creator and timestamps beyond updated_at are dropped.
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>",
"ref": "<ref>"
},
"name": "get_commit_statuses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | The commit, branch or tag whose statuses to read. | |
| page | No | 1-based page number. | |
| repo | Yes | Repository name. | |
| limit | No | Results per page. | |
| owner | Yes | Repository owner — user or organization. |