{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Lists check runs for a commit ref. The `ref` can be a SHA, branch name, or a tag name.\n\n> [!NOTE]\n> The endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.\n\nIf there are more than 1000 check suites on a single git reference, this endpoint will limit check runs to the 1000 most recent check suites. To iterate over all possible check runs, use the [List check suites for a Git reference](https://docs.github.com/rest/reference/checks#list-check-suites-for-a-git-reference) endpoint and provide the `check_suite_id` parameter to the [List check runs in a check suite](https://docs.github.com/rest/reference/checks#list-check-runs-in-a-check-suite) endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint on a private repository.","properties":{"path":{"type":"object","properties":{"owner":{"type":"string","description":"The account owner of the repository. The name is not case sensitive."},"repo":{"type":"string","description":"The name of the repository without the `.git` extension. The name is not case sensitive."},"ref":{"type":"string","description":"The commit reference. Can be a commit SHA, branch name (`heads/BRANCH_NAME`), or tag name (`tags/TAG_NAME`). For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation."}},"required":["owner","repo","ref"],"additionalProperties":false},"query":{"type":"object","properties":{"check_name":{"type":"string","description":"Returns check runs with the specified `name`."},"status":{"type":"string","enum":["queued","in_progress","completed"],"description":"Returns check runs with the specified `status`."},"filter":{"type":"string","enum":["latest","all"],"default":"latest","description":"Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs."},"per_page":{"type":"integer","default":30,"description":"The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""},"page":{"type":"integer","default":1,"description":"The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""},"app_id":{"type":"integer"}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"List check runs for a Git reference","id":"github.checks.list-for-ref","example":{"path":{"owner":"octocat","repo":"hello-world","ref":"heads/main"}},"maxRequests":1,"summary":false}}