GitHub integration
GitHub is supported through the Mach5 connector framework. This page lists every supported operation and where it can be used.
Connection

- Connector kind:
github - Configuration:
name,token_secret_ref, optionalapi_base_url, optionaldefault_owner.
How to use this integration
For Axon concepts, safety classes, idempotency, and outcomes, see Axon workflows.
Axon
Axon is the controlled action path for connector reads, enrichments, and side effects. Use Axon when a workflow needs to call GitHub directly, enrich an investigation, or take an approved action. Invoke the connector kind github with the operation name and JSON input.
connector: github
operation: lookup_user
input: { ... }
Ingest Pipelines
Use ingest pipelines for operations exposed as sources. These operations can checkpoint and stream records into Mach5-managed data.
source.connector: github
source.operation: list_repository_events
source.config: { ... }
SQL
Use SQL for read operations exposed as table or scalar functions. Query the connector operation with JSON input and join the result with Mach5 data.
SELECT *
FROM connector_table('github', 'lookup_user', JSON '{}');
Supported operations
| Operation | What it does | Axon | Ingest Pipelines | SQL |
|---|---|---|---|---|
validate | Validate GitHub credentials and API URL. | — | — | — |
lookup_user | Lookup a GitHub user by username. | Yes | — | Yes |
get_repository | Fetch GitHub repository metadata by owner and repo name. | Yes | — | Yes |
list_repository_events | List recent public GitHub repository events with bounded pagination. | — | Yes | Yes |
poll_audit_log_page | Fetch a durable caller-driven page of GitHub organization or enterprise audit log events. | — | Yes | — |
poll_workflow_runs_page | Fetch a durable caller-driven page of GitHub Actions workflow runs for a repository. | — | Yes | — |
poll_security_alerts_page | Fetch a durable caller-driven page of GitHub repository security alerts. | — | Yes | — |
poll_repository_events_page | Fetch a caller-driven page of GitHub repository events with Link-header checkpointing. | — | Yes | — |
parse_webhook_payload | Parse and normalize a GitHub webhook payload. | Yes | — | — |
get_authenticated_user | Fetch authenticated GitHub user identity. | Yes | — | Yes |
list_user_orgs | List organizations visible to the authenticated user or a named user. | Yes | — | Yes |
list_followers | List followers for the authenticated or named user. | Yes | — | Yes |
list_following | List users followed by the authenticated or named user. | Yes | — | Yes |
get_organization | Fetch GitHub organization metadata. | Yes | — | Yes |
list_org_members | List organization members with bounded pagination. | Yes | — | Yes |
list_outside_collaborators | List organization outside collaborators. | Yes | — | Yes |
list_teams | List organization teams. | Yes | — | Yes |
get_team_by_slug | Fetch an organization team by slug. | Yes | — | Yes |
list_team_members | List members of an organization team. | Yes | — | Yes |
list_team_repositories | List repositories associated with an organization team. | Yes | — | Yes |
list_org_repositories | List repositories for an organization. | Yes | — | Yes |
list_user_repositories | List repositories for a user. | Yes | — | Yes |
list_branches | List repository branches. | Yes | — | Yes |
list_tags | List repository tags. | Yes | — | Yes |
list_collaborators | List repository collaborators. | Yes | — | Yes |
get_languages | Fetch repository language byte counts. | Yes | — | Yes |
get_topics | Fetch repository topics. | Yes | — | Yes |
list_commits | List repository commits. | Yes | — | Yes |
get_commit | Fetch a repository commit. | Yes | — | Yes |
get_ref | Fetch a Git reference. | Yes | — | Yes |
list_refs | List Git references. | Yes | — | Yes |
compare_commits | Compare two commits or refs. | Yes | — | Yes |
list_issues | List repository issues. | Yes | — | Yes |
get_issue | Fetch a repository issue. | Yes | — | Yes |
list_issue_comments | List issue comments. | Yes | — | Yes |
list_pull_requests | List repository pull requests. | Yes | — | Yes |
get_pull_request | Fetch a repository pull request. | Yes | — | Yes |
list_pull_request_files | List files changed by a pull request. | Yes | — | Yes |
list_pull_request_reviews | List reviews for a pull request. | Yes | — | Yes |
list_releases | List repository releases. | Yes | — | Yes |
get_release | Fetch a repository release. | Yes | — | Yes |
list_workflows | List repository Actions workflows. | Yes | — | Yes |
list_workflow_runs | List repository Actions workflow runs. | Yes | — | Yes |
list_workflow_jobs | List jobs for a workflow run. | Yes | — | Yes |
list_artifacts | List repository Actions artifacts. | Yes | — | Yes |
list_workflow_artifacts | List repository Actions artifacts. | Yes | — | Yes |
list_deployments | List repository deployments. | Yes | — | Yes |
list_environments | List repository environments. | Yes | — | Yes |
update_environment | Create or update a repository environment. | Yes | — | — |
list_packages | List organization packages. | Yes | — | Yes |
get_package | Fetch organization package metadata. | Yes | — | Yes |
delete_package | Delete an organization package. | Yes | — | — |
list_code_scanning_alerts | List repository code scanning alerts. | Yes | — | Yes |
list_secret_scanning_alerts | List repository secret scanning alerts. | Yes | — | Yes |
list_dependabot_alerts | List repository Dependabot alerts. | Yes | — | Yes |
list_security_advisories | List repository security advisories. | Yes | — | Yes |
list_org_audit_log | List organization audit log events. | Yes | — | Yes |
list_enterprise_audit_log | List enterprise audit log events. | Yes | — | Yes |
list_hooks | List repository webhooks. | Yes | — | Yes |
list_webhooks | List repository webhooks. | Yes | — | Yes |
get_hook | Fetch repository webhook metadata. | Yes | — | Yes |
search_repositories | Bounded repository search. | Yes | — | Yes |
search_users | Bounded user search. | Yes | — | Yes |
search_issues | Bounded issue and pull request search. | Yes | — | Yes |
search_code | Bounded code search. | Yes | — | Yes |
graphql_query | Execute a bounded read-only GitHub GraphQL query. | Yes | — | Yes |
graphql_read | Execute a bounded read-only GitHub GraphQL query. | Yes | — | Yes |
create_repository | Create a repository for the authenticated user or an organization. | Yes | — | — |
update_repository | Update repository metadata. | Yes | — | — |
create_issue | Create a repository issue. | Yes | — | — |
update_issue | Update a repository issue. | Yes | — | — |
create_issue_comment | Create an issue comment. | Yes | — | — |
comment_issue | Create an issue comment. | Yes | — | — |
add_issue_labels | Add labels to an issue. | Yes | — | — |
label_issue | Add labels to an issue. | Yes | — | — |
create_pull_request | Create a repository pull request. | Yes | — | — |
update_pull_request | Update a pull request. | Yes | — | — |
merge_pull_request | Merge a pull request. | Yes | — | — |
create_pull_request_review | Create a pull request review. | Yes | — | — |
review_pull_request | Create a pull request review. | Yes | — | — |
comment_pull_request | Create a pull request review comment. | Yes | — | — |
create_release | Create a repository release. | Yes | — | — |
update_release | Update a repository release. | Yes | — | — |
delete_release | Delete a repository release. | Yes | — | — |
rerun_workflow_run | Rerun a GitHub Actions workflow run. | Yes | — | — |
cancel_workflow_run | Cancel a GitHub Actions workflow run. | Yes | — | — |
create_repository_dispatch | Create a repository_dispatch event. | Yes | — | — |
create_hook | Create a repository webhook. | Yes | — | — |
create_webhook | Create a repository webhook. | Yes | — | — |
update_hook | Update a repository webhook. | Yes | — | — |
update_webhook | Update a repository webhook. | Yes | — | — |
delete_hook | Delete a repository webhook. | Yes | — | — |
delete_webhook | Delete a repository webhook. | Yes | — | — |
ping_hook | Ping a repository webhook. | Yes | — | — |
graphql_mutation | Execute an approved GitHub GraphQL mutation. | Yes | — | — |