add_issue_assignees
ChatGPTAdd assignees to an issue or pull request. Returns a normalized issue snapshot after the mutation. Docs: https://docs.github.com/en/rest/issues/assignees?apiVersion=2022-11-28#add-assignees-to-an-issue
add_issue_labels
ChatGPTAdd labels to an issue or pull request. Returns a normalized issue snapshot after the mutation. Docs: https://docs.github.com/en/rest/issues/labels?apiVersion=2022-11-28#add-labels-to-an-issue
add_reaction_to_pr
ChatGPTAdd a reaction to a GitHub pull request.
add_review_to_pr
ChatGPTAdd a review to a GitHub pull request. review is required for REQUEST_CHANGES and COMMENT events.
check_repo_initialized
ChatGPTCheck 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
ChatGPTCompare 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.
convert_pull_request_to_draft
ChatGPTConvert an open pull request back to draft state. Returns the connector's normalized PR snapshot after the transition. Docs: https://docs.github.com/en/graphql/reference/mutations#convertpullrequesttodraft
create_blob
ChatGPTCreate a blob in the repository and return its SHA.
create_branch
ChatGPTCreate a new branch from exactly one existing commit SHA or base ref.
create_check_run
ChatGPTCreate a GitHub Check Run using the Codex GitHub App.
create_commit
ChatGPTCreate a commit pointing to tree_sha with one or more parents.
create_file
ChatGPTCreate a new UTF-8 text file through GitHub's contents API. Returns only the resulting commit SHA, not GitHub's full content/commit payload. Docs: https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#create-or-update-file-contents
create_issue
ChatGPTCreate a GitHub issue. Returns a normalized issue snapshot, not GitHub's raw REST payload. Docs: https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#create-an-issue
create_pull_request
ChatGPTOpen a pull request in the repository. Returns the connector's normalized PR snapshot, not the full REST response payload. Docs: https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#create-a-pull-request
create_tree
ChatGPTCreate a tree object in the repository from the given elements.
delete_file
ChatGPTDelete a file through GitHub's contents API. Returns only the resulting commit SHA. Docs: https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#delete-a-file
dismiss_pull_request_review
ChatGPTDismiss a submitted pull request review. Returns the normalized review snapshot after dismissal. Docs: https://docs.github.com/en/graphql/reference/mutations#dismisspullrequestreview
download_git_tree_archive
ChatGPTStream GitHub's compressed archive for one immutable Git tree into private storage.
download_user_content
ChatGPTDownload 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
ChatGPTDownload 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: https://docs.github.com/en/rest/actions/artifacts?apiVersion=2022-11-28#download-an-artifact
enable_auto_merge
ChatGPTEnable auto-merge for a pull request. This wrapper infers the merge method from repository settings and returns only success. Docs: https://docs.github.com/en/graphql/reference/mutations#enablepullrequestautomerge
fetch
ChatGPTFetch 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
ChatGPTFetch blob content by SHA from the given repository.
fetch_commit
ChatGPTFetch a commit with its metadata, diff, and canonical URL.
fetch_commit_workflow_runs
ChatGPTFetch 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: https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#list-workflow-runs-for-a-repository
fetch_file
ChatGPTFetch file content by repository path, using the default branch when ref is omitted.
fetch_git_blob
ChatGPTFetch Git blob bytes.
fetch_issue
ChatGPTFetch a GitHub issue. You must populate exactly one of repository_full_name, repository_id, or repository_url to select the issue's repository.
fetch_pr
ChatGPTFetch a pull request with its diff, metadata, and optionally comments.
fetch_pr_file_patch
ChatGPTFetch 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
ChatGPTFetch the patch for a GitHub pull request across all changed-file pages.
fetch_workflow_job_logs
ChatGPTFetch 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: https://docs.github.com/en/rest/actions/workflow-jobs?apiVersion=2022-11-28#download-job-logs-for-a-workflow-run-job
fetch_workflow_job_steps
ChatGPTFetch steps for a GitHub Actions workflow job. Returns only step summaries, not the full job payload. Docs: https://docs.github.com/en/rest/actions/workflow-jobs?apiVersion=2022-11-28#get-a-job-for-a-workflow-run
fetch_workflow_run_artifacts
ChatGPTFetch artifacts for a GitHub Actions workflow run. This wrapper returns the first page only. Docs: https://docs.github.com/en/rest/actions/artifacts?apiVersion=2022-11-28#list-workflow-run-artifacts
fetch_workflow_run_jobs
ChatGPTFetch jobs for a GitHub Actions workflow run. This wrapper returns the latest attempt's jobs from the first page only. Docs: https://docs.github.com/en/rest/actions/workflow-jobs?apiVersion=2022-11-28#list-jobs-for-a-workflow-run
get_check_run
ChatGPTReturn a Check Run only when it belongs to the requested GitHub App.
get_commit_combined_status
ChatGPTFetch the combined CI status and individual status checks for a commit.
get_commit_diff
ChatGPTFetch a raw commit diff or patch.
get_commit_tree_sha
ChatGPTReturn root tree SHA.
get_latest_check_run
ChatGPTReturn the latest matching Check Run for a commit or ref.
get_pr_diff
ChatGPTFetch just the diff or patch text for a pull request.
get_pr_info
ChatGPTGet 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
ChatGPTExplicitly 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
ChatGPTFetch reactions for a GitHub pull request.
get_pr_statuses
ChatGPTRead 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
ChatGPTRetrieve the GitHub profile for the authenticated user.
get_repo
ChatGPTRetrieve 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: https://docs.github.com/en/rest/repos/repos#get-a-repository GitHub Enterprise Server REST docs: https://docs.github.com/en/enterprise-server@latest/rest/using-the-rest-api/getting-started-with-the-rest-api GHE.com API host docs: https://docs.github.com/en/enterprise-cloud@latest/admin/data-residency/about-github-enterprise-cloud-with-data-residency#api-access
get_repo_collaborator_permission
ChatGPTReturn the collaborator permission level for a user on a repository.
get_repo_installation_id
ChatGPTGet the GitHub App installation ID for a repository visible to the linked account.
get_repos
ChatGPTRead 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
ChatGPTReturn the GitHub login for the authenticated user.
get_users_recent_prs_in_repo
ChatGPTList 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.
label_pr
ChatGPTLabel a pull request.
list_commits
ChatGPTList commits for a repository in newest-first GitHub API order.
list_directory
ChatGPTList entries in a repository directory, using the default branch when ref is omitted.
list_git_tree
ChatGPTList tree children.
list_git_tree_recursive
ChatGPTList every descendant of one immutable Git tree.
list_installations
ChatGPTList installations, optionally limited to managed setup account types.
list_installed_accounts
ChatGPTList all accounts that the user has installed our GitHub app on.
list_pr_changed_filenames
ChatGPTList changed filenames for a PR across all paginated file-list pages.
list_pull_request_review_threads
ChatGPTList inline review threads on a pull request, including resolved state. Returns GraphQL review thread nodes, including comment bodies and resolution metadata. Docs: https://docs.github.com/en/graphql/reference/objects#pullrequestreviewthread
list_pull_request_reviews
ChatGPTList review submissions on a pull request. Returns GraphQL review nodes normalized into the connector's review model. Docs: https://docs.github.com/en/graphql/reference/objects#pullrequestreview
list_recent_issues
ChatGPTReturn 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
ChatGPTList repositories accessible to the authenticated user.
list_repositories_by_affiliation
ChatGPTList repositories accessible to the authenticated user filtered by affiliation.
list_repositories_by_installation
ChatGPTList repositories accessible to the authenticated user.
list_user_org_memberships
ChatGPTList the authenticated user's organization memberships.
list_user_orgs
ChatGPTList organizations the authenticated user is a member of.
lock_issue_conversation
ChatGPTLock an issue or pull request conversation. Allowed lock_reason values are off-topic, too heated, resolved, and spam. Docs: https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#lock-an-issue
mark_pull_request_ready_for_review
ChatGPTMark a draft pull request as ready for review. Returns the connector's normalized PR snapshot after the transition. Docs: https://docs.github.com/en/graphql/reference/mutations#markpullrequestreadyforreview
merge_pull_request
ChatGPTMerge a pull request immediately. Returns GitHub's merge result payload (sha, merged, message). Docs: https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#merge-a-pull-request
remove_issue_assignees
ChatGPTRemove assignees from an issue or pull request. Returns a normalized issue snapshot after the mutation. Docs: https://docs.github.com/en/rest/issues/assignees?apiVersion=2022-11-28#remove-assignees-from-an-issue
remove_issue_label
ChatGPTRemove one label from an issue or pull request. Returns a normalized issue snapshot after the mutation. Docs: https://docs.github.com/en/rest/issues/labels?apiVersion=2022-11-28#remove-a-label-from-an-issue
remove_pull_request_reviewers
ChatGPTRemove individual or team reviewer requests from a pull request. Returns the connector's normalized PR snapshot after the mutation. Docs: https://docs.github.com/en/rest/pulls/review-requests?apiVersion=2022-11-28#remove-requested-reviewers-from-a-pull-request
remove_reaction_from_pr
ChatGPTRemove a reaction from a GitHub pull request.
request_pull_request_reviewers
ChatGPTRequest individual or team reviewers on a pull request. Returns the connector's normalized PR snapshot after the review request mutation. Docs: https://docs.github.com/en/rest/pulls/review-requests?apiVersion=2022-11-28#request-reviewers-for-a-pull-request
rerun_failed_workflow_run_jobs
ChatGPTRe-run all failed jobs in a GitHub Actions workflow run. Use this to retry only the failed jobs from a workflow run, instead of starting a full new attempt for successful jobs too. The linked GitHub app or token must have GitHub Actions write permission for the repository. Docs: https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#re-run-failed-jobs-from-a-workflow-run
rerun_workflow_job
ChatGPTRe-run one GitHub Actions workflow job. Use this when a specific failed or cancelled job should be retried without re-running every failed job in the workflow run. The linked GitHub app or token must have GitHub Actions write permission for the repository. Docs: https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#re-run-a-job-from-a-workflow-run
resolve_ref
ChatGPTResolve a branch, tag, or commit-ish ref to a commit SHA.
resolve_review_thread
ChatGPTResolve an inline pull request review thread. Docs: https://docs.github.com/en/graphql/reference/mutations#resolvereviewthread
search
ChatGPTSearch 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
ChatGPTSearch GitHub branches within a repository.
search_commits
ChatGPTSearch 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
ChatGPTSearch for a repository (not a file) by name or description. To search for a file, use search.
search_installed_repositories_v2
ChatGPTSearch repositories within the user's installations using GitHub search.
search_issues
ChatGPTSearch 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
ChatGPTSearch GitHub pull requests globally, by organization, or optionally by repository.
search_repositories
ChatGPTSearch for a repository (not a file) by name or description. To search for a file, use search.
unlock_issue_conversation
ChatGPTUnlock an issue or pull request conversation. Docs: https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#unlock-an-issue
unresolve_review_thread
ChatGPTMark an inline pull request review thread as unresolved. Docs: https://docs.github.com/en/graphql/reference/mutations#unresolvereviewthread
update_check_run
ChatGPTUpdate a GitHub Check Run using the Codex GitHub App.
update_file
ChatGPTReplace a UTF-8 text file through GitHub's contents API. Returns the resulting commit SHA and content blob SHA. Use content_sha for a subsequent sequential update. Do not run update/delete writes for the same path in parallel. Docs: https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#create-or-update-file-contents
update_issue
ChatGPTUpdate a GitHub issue, including title/body, state, labels, assignees, or milestone. Returns a normalized issue snapshot after the patch. Docs: https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#update-an-issue
update_pull_request
ChatGPTUpdate PR metadata, base branch, or open/closed state. Returns the connector's normalized PR snapshot. Docs: https://docs.github.com/en/rest/pulls/pulls?apiVersion=2022-11-28#update-a-pull-request
update_ref
ChatGPTMove a branch ref to a commit, rejecting a mismatched expected_sha. Inspect the new branch head before retrying a rejected lease.
upsert_actions_secret
ChatGPTCreate or replace a GitHub Actions repository secret. Use this private action only for server-managed repository setup. The linked GitHub account must have permission to manage Actions secrets for the repository. The plaintext value is sealed with the repository's current GitHub public key before it is uploaded and is not included in the action response.