| check_repo_initialized |
Check whether a GitHub repository has been set up. You must populate exactly one of repository_full_name, repository_id, or repository_url to select the repository. |
| compare_commits |
Compare two commits/refs and return per-file stats plus compare metadata. This is a thin wrapper around GithubPlugin.compare_commits to provide a stable, compact response shape to connector consumers. |
| download_git_tree_archive |
Stream GitHub's compressed archive for one immutable Git tree into private storage. |
| download_user_content |
Download a GitHub private user image attachment URL. Use this only for private-user-images.githubusercontent.com URLs, such as GitHub issue or pull request image uploads. Use fetch or fetch_file for repository files. |
| download_workflow_artifact |
Download a GitHub Actions workflow artifact ZIP archive. GitHub serves this endpoint through a temporary redirect; the underlying client follows that redirect before returning a reusable file reference for the ZIP bytes. Docs: GitHub docs |
| fetch |
Fetch approved public GitHub repository resources and repository files. Supports repositories, directories, code and issue search, and blob or raw file URLs. Pull requests, issues, commits, branches, workflow runs, releases, Git data, commit statuses, and rulesets include their collections and subresources via GET only, including branch-protection and ruleset reads. The active connection's repository permissions still apply. Managed GitHub App installation connections exclude administration access, so they cannot read branch-protection endpoints that require that permission. Unlisted API endpoints and non-public-GitHub hosts are rejected. Sensitive endpoint families, such as user, organization, and secrets APIs, are not supported. Contents URLs without a ref use the repository's default branch. JSON responses are returned unchanged; oversized or non-UTF-8 responses are rejected, so binary downloads are not supported. |
| fetch_blob |
Fetch blob content by SHA from the given repository. |
| fetch_commit |
Fetch a commit with its metadata, diff, and canonical URL. |
| fetch_commit_workflow_runs |
Fetch GitHub Actions workflow runs associated with a commit SHA. This wrapper currently filters to pull-request-triggered runs and returns the first page only. Docs: GitHub docs |
| fetch_file |
Fetch file content by repository path, using the default branch when ref is omitted. |
| fetch_git_blob |
Fetch Git blob bytes. |
| fetch_issue |
Fetch a GitHub issue. You must populate exactly one of repository_full_name, repository_id, or repository_url to select the issue's repository. |
| fetch_issue_comments |
Fetch comments for a GitHub issue across all pages. |
| fetch_pr |
Fetch a pull request with its diff, metadata, and optionally comments. |
| fetch_pr_comments |
Fetch a merged PR discussion timeline. The returned list combines issue comments, inline review comments, and review submissions into one normalized array. Docs: GitHub docs Docs: GitHub docs Docs: GitHub docs |
| fetch_pr_file_patch |
Fetch the patch for one validated changed file in an accessible pull request. Call list_pr_changed_filenames first, then pass an exact returned path. A valid pull request that does not contain the path returns patch=null. A 404 means GitHub could not resolve the repository or pull request; do not retry other paths. |
| fetch_pr_patch |
Fetch the patch for a GitHub pull request across all changed-file pages. |
| fetch_workflow_job_logs |
Fetch decoded logs for a GitHub Actions workflow job. GitHub serves this endpoint through a temporary redirect; the underlying client follows that redirect before decoding the bytes. Docs: GitHub docs |
| fetch_workflow_job_steps |
Fetch steps for a GitHub Actions workflow job. Returns only step summaries, not the full job payload. Docs: GitHub docs |
| fetch_workflow_run_artifacts |
Fetch artifacts for a GitHub Actions workflow run. This wrapper returns the first page only. Docs: GitHub docs |
| fetch_workflow_run_jobs |
Fetch jobs for a GitHub Actions workflow run. This wrapper returns the latest attempt's jobs from the first page only. Docs: GitHub docs |
| get_check_run |
Return a Check Run only when it belongs to the requested GitHub App. |
| get_commit_combined_status |
Fetch the combined CI status and individual status checks for a commit. |
| get_commit_diff |
Fetch a raw commit diff or patch. |
| get_commit_tree_sha |
Return root tree SHA. |
| get_issue_comment_reactions |
Fetch reactions for an issue comment. |
| get_latest_check_run |
Return the latest matching Check Run for a commit or ref. |
| get_pr_diff |
Fetch just the diff or patch text for a pull request. |
| get_pr_info |
Get metadata (title, description, refs, and status) for a pull request. This action does not include the actual code changes. If you need the diff or per-file patches, call fetch_pr_patch instead (or use get_users_recent_prs_in_repo with include_diff=True when listing the user's own PRs). |
| get_pr_mergeability |
Explicitly read merge readiness for one pull request using the linked account. Call when merge controls need readiness, rather than during routine status polling. UNKNOWN is pending, not a conflict. Use this result only while both returned head and base revisions match the displayed pull request; GitHub enforces policy on merge. |
| get_pr_reactions |
Fetch reactions for a GitHub pull request. |
| get_pr_review_comment_reactions |
Fetch reactions for a pull request review comment. |
| get_pr_statuses |
Read compact pull request snapshots and checks in one app-only batch. Results preserve input order. Incomplete checks retain observed failures; callers must not treat them as proof that all checks passed. Legacy readiness fields are always UNKNOWN; use get_pr_mergeability for an explicit readiness read. |
| get_profile |
Retrieve the GitHub profile for the authenticated user. |
| get_repo |
Retrieve metadata for a GitHub repository. You must populate exactly one of repository_full_name, repository_id, or repository_url: - repository_full_name: owner/name, such as openai/openai. Maps to GitHub REST owner and repo path parameters. - repository_id: numeric GitHub repository ID, such as 1296269. - repository_url: repository URL or nested repository URL, such as a PR, issue, branch, file, REST API, GitHub Enterprise Server /api/v3, or GHE.com API URL. GitHub REST repository docs: GitHub docs GitHub Enterprise Server REST docs: GitHub docs GHE.com API host docs: GitHub docs |
| get_repo_collaborator_permission |
Return the collaborator permission level for a user on a repository. |
| get_repo_installation_id |
Get the GitHub App installation ID for a repository visible to the linked account. |
| get_repos |
Read current repository identities and visibility with the linked credential. Names are batched through GraphQL and checked against supplied numeric IDs. Missing or stale hints use REST to resolve the authoritative numeric ID. Results preserve input order and include null for a repository that is not found. Authentication and policy errors fail the action rather than returning null. |
| get_user_login |
Return the GitHub login for the authenticated user. |
| get_users_recent_prs_in_repo |
List the user's recent GitHub pull requests in a repository. limit is the final number of PRs returned. The connector paginates the underlying GitHub search endpoint to satisfy larger limits. |
| list_commits |
List commits for a repository in newest-first GitHub API order. |
| list_directory |
List entries in a repository directory, using the default branch when ref is omitted. |
| list_git_tree |
List tree children. |
| list_git_tree_recursive |
List every descendant of one immutable Git tree. |
| list_installations |
List accessible installations, optionally filtering to managed setup accounts. |
| list_installed_accounts |
List all accounts that the user has installed our GitHub app on. |
| list_pr_changed_filenames |
List changed filenames for a PR across all paginated file-list pages. |
| list_pull_request_review_threads |
List inline review threads on a pull request, including resolved state. Returns GraphQL review thread nodes, including comment bodies and resolution metadata. Docs: GitHub docs |
| list_pull_request_reviews |
List review submissions on a pull request. Returns GraphQL review nodes normalized into the connector's review model. Docs: GitHub docs |
| list_recent_issues |
Return the most recent GitHub issues the user can access. top_k is the final result limit. The connector transparently paginates GitHub's issues API until that limit is reached or no more pages exist. |
| list_repositories |
List repositories accessible to the authenticated user. |
| list_repositories_by_affiliation |
List repositories accessible to the authenticated user filtered by affiliation. |
| list_repositories_by_installation |
List repositories accessible to the authenticated user. |
| list_user_org_memberships |
List the authenticated user's organization memberships. |
| list_user_orgs |
List organizations the authenticated user is a member of. |
| resolve_ref |
Resolve a branch, tag, or commit-ish ref to a commit SHA. |
| search |
Search GitHub files and return matching excerpts when available. Provide a plain string query, avoid GitHub query flags such as is:pr. Include keywords that match file names, functions, or error messages. repository_name or org can narrow the search scope. Example: query="tokenizer bug" repository_name="openai/tiktoken" or query="tokenizer bug" repository_name="tiktoken" org="openai". Fully qualified repository names keep their explicit owner even when org is set. Code search covers the default branch. Use fetch_file for full file contents. topn is the number of results to return. No results are returned if the query is empty. |
| search_branches |
Search GitHub branches within a repository. |
| search_commits |
Search GitHub commits globally, by organization, or optionally by repository. Include at least one non-qualifier search term in the query. To list recent commits without matching text, pass an empty query with repository_full_name and use the default descending order. |
| search_installed_repositories_streaming |
Search for a repository (not a file) by name or description. To search for a file, use search. |
| search_installed_repositories_v2 |
Search repositories within the user's installations using GitHub search. |
| search_issues |
Search one repository or every repository the linked account can access. Supply at most one repository selector. Empty lists mean no repository filter. A repo:owner/name query does not require a separate repository selector. |
| search_prs |
Search GitHub pull requests globally, by organization, or optionally by repository. |
| search_repositories |
Search for a repository (not a file) by name or description. To search for a file, use search. |