Note: This article contains the events that may appear in your organization's audit log. For the events that can appear in a user account's security log or the audit log for an enterprise, see "Security log events" and "Audit log events for your enterprise."
business
category actions
Action | Description |
---|---|
set_actions_retention_limit | Triggered when the retention period for GitHub Actions artifacts and logs is changed for an enterprise. For more information, see "Enforcing policies for GitHub Actions in your enterprise." |
set_fork_pr_workflows_policy | Triggered when the policy for workflows on private repository forks is changed. For more information, see "Enabling workflows for private repository forks." |
dependabot_alerts
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables Dependabot alerts for all existing repositories. For more information, see "Managing security and analysis settings for your organization." |
enable | Triggered when an organization owner enables Dependabot alerts for all existing repositories. |
dependabot_alerts_new_repos
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables Dependabot alerts for all new repositories. For more information, see "Managing security and analysis settings for your organization." |
enable | Triggered when an organization owner enables Dependabot alerts for all new repositories. |
dependabot_security_updates
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables Dependabot security updates for all existing repositories. For more information, see "Managing security and analysis settings for your organization." |
enable | Triggered when an organization owner enables Dependabot security updates for all existing repositories. |
dependabot_security_updates_new_repos
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables Dependabot security updates for all new repositories. For more information, see "Managing security and analysis settings for your organization." |
enable | Triggered when an organization owner enables Dependabot security updates for all new repositories. |
discussion_post
category actions
Action | Description |
---|---|
update | Triggered when a team discussion post is edited. |
destroy | Triggered when a team discussion post is deleted. |
discussion_post_reply
category actions
Action | Description |
---|---|
update | Triggered when a reply to a team discussion post is edited. |
destroy | Triggered when a reply to a team discussion post is deleted. |
enterprise
category actions
Action | Description |
---|---|
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. For more information, see "Adding self-hosted runners." |
runner_group_created | Triggered when a self-hosted runner group is created. For more information, see "Managing access to self-hosted runners using groups. |
runner_group_removed | Triggered when a self-hosted runner group is removed. For more information, see "Managing access to self-hosted runners using groups." |
runner_group_runner_removed | Triggered when the REST API is used to remove a self-hosted runner from a group. |
runner_group_runners_added | Triggered when a self-hosted runner is added to a group. For more information, see "Managing access to self-hosted runners using groups." |
runner_group_runners_updated | Triggered when a runner group's list of members is updated. For more information, see "Actions." |
runner_group_updated | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "Managing access to self-hosted runners using groups." |
self_hosted_runner_updated | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "About self-hosted runners." |
hook
category actions
Action | Description |
---|---|
create | Triggered when a new hook was added to a repository owned by your organization. |
config_changed | Triggered when an existing hook has its configuration altered. |
destroy | Triggered when an existing hook was removed from a repository. |
events_changed | Triggered when the events on a hook have been altered. |
integration_installation
category actions
Action | Description |
---|---|
contact_email_changed | A contact email for an integration was changed. |
create | An integration was installed. |
destroy | An integration was uninstalled. |
repositories_added | Repositories were added to an integration. |
repositories_removed | Repositories were removed from an integration. |
version_updated | Permissions for an integration were updated. |
integration_installation_request
category actions
Action | Description |
---|---|
create | Triggered when an organization member requests that an organization owner install an integration for use in the organization. |
close | Triggered when a request to install an integration for use in an organization is either approved or denied by an organization owner, or canceled by the organization member who opened the request. |
issue
category actions
Action | Description |
---|---|
destroy | Triggered when an organization owner or someone with admin permissions in a repository deletes an issue from an organization-owned repository. |
members_can_create_pages
category actions
For more information, see "Managing the publication of GitHub Pages sites for your organization."
Action | Description |
---|---|
enable | Triggered when an organization owner enables publication of GitHub Pages sites for repositories in the organization. |
disable | Triggered when an organization owner disables publication of GitHub Pages sites for repositories in the organization. |
oauth_application
category actions
Action | Description |
---|---|
create | Triggered when a new OAuth app is created. |
destroy | Triggered when an existing OAuth app is deleted. |
reset_secret | Triggered when an OAuth app's client secret is reset. |
revoke_tokens | Triggered when an OAuth app's user tokens are revoked. |
transfer | Triggered when an existing OAuth app is transferred to a new organization. |
org
category actions
Action | Description |
---|---|
add_member | Triggered when a user joins an organization. |
advanced_security_policy_selected_member_disabled | Triggered when an enterprise owner prevents GitHub Advanced Security features from being enabled for repositories owned by the organization. For more information, see "Enforcing policies for Advanced Security in your enterprise." |
advanced_security_policy_selected_member_enabled | Triggered when an enterprise owner allows GitHub Advanced Security features to be enabled for repositories owned by the organization. For more information, see "Enforcing policies for Advanced Security in your enterprise." |
create_actions_secret | Triggered when a GitHub Actions secret is created for an organization. For more information, see "Encrypted secrets." |
disable_member_team_creation_permission | Triggered when an organization owner limits team creation to owners. For more information, see "Setting team creation permissions in your organization." |
disable_two_factor_requirement | Triggered when an owner disables a two-factor authentication requirement for all members and outside collaborators in an organization. |
enable_member_team_creation_permission | Triggered when an organization owner allows members to create teams. For more information, see "Setting team creation permissions in your organization." |
enable_two_factor_requirement | Triggered when an owner requires two-factor authentication for all members and outside collaborators in an organization. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. For more information, see "Adding self-hosted runners." |
remove_actions_secret | Triggered when a GitHub Actions secret is removed. |
remove_member | Triggered when an owner removes a member from an organization or when two-factor authentication is required in an organization and an organization member doesn't use 2FA or disables 2FA. Also triggered when an organization member removes themselves from an organization. |
remove_outside_collaborator | Triggered when an owner removes an outside collaborator from an organization or when two-factor authentication is required in an organization and an outside collaborator does not use 2FA or disables 2FA. |
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. For more information, see "Removing self-hosted runners." |
runner_group_created | Triggered when a self-hosted runner group is created. For more information, see "Managing access to self-hosted runners using groups." |
runner_group_removed | Triggered when a self-hosted runner group is removed. For more information, see "Managing access to self-hosted runners using groups." |
runner_group_updated | Triggered when the configuration of a self-hosted runner group is changed. For more information, see "Managing access to self-hosted runners using groups." |
runner_group_runners_added | Triggered when a self-hosted runner is added to a group. For more information, see Moving a self-hosted runner to a group. |
runner_group_runner_removed | Triggered when the REST API is used to remove a self-hosted runner from a group. For more information, see "Actions." |
runner_group_runners_updated | Triggered when a runner group's list of members is updated. For more information, see "Actions." |
secret_scanning_push_protection_disable | Triggered when an organization owner or person with admin access to the organization disables push protection for secret scanning. For more information, see "Protecting pushes with secret scanning." |
secret_scanning_push_protection_enable | Triggered when an organization owner or person with admin access to the organization enables push protection for secret scanning. |
self_hosted_runner_online | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "Monitoring and troubleshooting self-hosted runners." |
self_hosted_runner_offline | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "Monitoring and troubleshooting self-hosted runners." |
self_hosted_runner_updated | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "About self-hosted runners." |
set_actions_retention_limit | Triggered when the retention period for GitHub Actions artifacts and logs is changed. For more information, see "Enforcing policies for GitHub Actions in your enterprise." |
set_fork_pr_workflows_policy | Triggered when the policy for workflows on private repository forks is changed. For more information, see "Disabling or limiting GitHub Actions for your organization." |
update_actions_secret | Triggered when a GitHub Actions secret is updated. |
update_new_repository_default_branch_setting | Triggered when an owner changes the name of the default branch for new repositories in the organization. For more information, see "Managing the default branch name for repositories in your organization." |
update_default_repository_permission | Triggered when an owner changes the default repository permission level for organization members. |
update_member | Triggered when an owner changes a person's role from owner to member or member to owner. |
update_member_repository_creation_permission | Triggered when an owner changes the create repository permission for organization members. |
org_secret_scanning_custom_pattern
category actions
Action | Description |
---|---|
create | Triggered when a custom pattern is created for secret scanning in an organization. For more information, see "Defining custom patterns for secret scanning." |
delete | Triggered when a custom pattern is removed from secret scanning in an organization. For more information, see "Defining custom patterns for secret scanning." |
publish | Triggered when changes to a custom pattern are published for secret scanning in an organization. For more information, see "Defining custom patterns for secret scanning." |
update | Triggered when changes to a custom pattern are saved and a dry run is executed for secret scanning in an organization. For more information, see "Defining custom patterns for secret scanning." |
organization_default_label
category actions
Action | Description |
---|---|
create | Triggered when a default label is created. |
update | Triggered when a default label is edited. |
destroy | Triggered when a default label is deleted. |
profile_picture
category actions
Action | Description |
---|---|
update | Triggered when you set or update your organization's profile picture. |
project
category actions
Action | Description |
---|---|
create | Triggered when a project board is created. |
link | Triggered when a repository is linked to a project board. |
rename | Triggered when a project board is renamed. |
update | Triggered when a project board is updated. |
delete | Triggered when a project board is deleted. |
unlink | Triggered when a repository is unlinked from a project board. |
update_org_permission | Triggered when the base-level permission for all organization members is changed or removed. |
update_team_permission | Triggered when a team's project board permission level is changed or when a team is added or removed from a project board. |
update_user_permission | Triggered when an organization member or outside collaborator is added to or removed from a project board or has their permission level changed. |
protected_branch
category actions
Action | Description |
---|---|
create | Triggered when branch protection is enabled on a branch. |
destroy | Triggered when branch protection is disabled on a branch. |
update_admin_enforced | Triggered when branch protection is enforced for repository administrators. |
update_require_code_owner_review | Triggered when enforcement of required Code Owner review is updated on a branch. |
dismiss_stale_reviews | Triggered when enforcement of dismissing stale pull requests is updated on a branch. |
update_signature_requirement_enforcement_level | Triggered when enforcement of required commit signing is updated on a branch. |
update_pull_request_reviews_enforcement_level | Triggered when enforcement of required pull request reviews is updated on a branch. Can be one of 0 (deactivated), 1 (non-admins), 2 (everyone). |
update_required_status_checks_enforcement_level | Triggered when enforcement of required status checks is updated on a branch. |
update_strict_required_status_checks_policy | Triggered when the requirement for a branch to be up to date before merging is changed. |
rejected_ref_update | Triggered when a branch update attempt is rejected. |
policy_override | Triggered when a branch protection requirement is overridden by a repository administrator. |
update_allow_force_pushes_enforcement_level | Triggered when force pushes are enabled or disabled for a protected branch. |
update_allow_deletions_enforcement_level | Triggered when branch deletion is enabled or disabled for a protected branch. |
update_linear_history_requirement_enforcement_level | Triggered when required linear commit history is enabled or disabled for a protected branch. |
pull_request
category actions
Action | Description |
---|---|
create | Triggered when a pull request is created. |
close | Triggered when a pull request is closed without being merged. |
reopen | Triggered when a pull request is reopened after previously being closed. |
merge | Triggered when a pull request is merged. |
indirect_merge | Triggered when a pull request is considered merged because its commits were merged into the target branch. |
ready_for_review | Triggered when a pull request is marked as ready for review. |
converted_to_draft | Triggered when a pull request is converted to a draft. |
create_review_request | Triggered when a review is requested. |
remove_review_request | Triggered when a review request is removed. |
pull_request_review
category actions
Action | Description |
---|---|
submit | Triggered when a review is submitted. |
dismiss | Triggered when a review is dismissed. |
delete | Triggered when a review is deleted. |
pull_request_review_comment
category actions
Action | Description |
---|---|
create | Triggered when a review comment is added. |
update | Triggered when a review comment is changed. |
delete | Triggered when a review comment is deleted. |
repo
category actions
Action | Description |
---|---|
access | Triggered when a user changes the visibility of a repository in the organization. |
actions_enabled | Triggered when GitHub Actions is enabled for a repository. Can be viewed using the UI. This event is not included when you access the audit log using the REST API. For more information, see "Using the audit log API." |
add_member | Triggered when a user accepts an invitation to have collaboration access to a repository. |
add_topic | Triggered when a repository admin adds a topic to a repository. |
advanced_security_disabled | Triggered when a repository administrator disables GitHub Advanced Security features for the repository. For more information, see "Managing security and analysis settings for your repository." |
advanced_security_enabled | Triggered when a repository administrator enables GitHub Advanced Security features for the repository. For more information, see "Managing security and analysis settings for your repository.". |
archived | Triggered when a repository admin archives a repository. |
config.disable_anonymous_git_access | Triggered when anonymous Git read access is disabled in a public repository. |
config.enable_anonymous_git_access | Triggered when anonymous Git read access is enabled in a public repository. |
config.lock_anonymous_git_access | Triggered when a repository's anonymous Git read access setting is locked. |
config.unlock_anonymous_git_access | Triggered when a repository's anonymous Git read access setting is unlocked. |
create | Triggered when a new repository is created. |
create_actions_secret | Triggered when a GitHub Actions secret is created for a repository. For more information, see "Encrypted secrets." |
destroy | Triggered when a repository is deleted. |
download_zip | A source code archive of a repository was downloaded as a ZIP file. For more information, see "Downloading source code archives." |
enable | Triggered when a repository is re-enabled. |
remove_actions_secret | Triggered when a GitHub Actions secret is removed. |
remove_member | Triggered when a user is removed from a repository as a collaborator. |
register_self_hosted_runner | Triggered when a new self-hosted runner is registered. For more information, see "Adding self-hosted runners." |
remove_self_hosted_runner | Triggered when a self-hosted runner is removed. For more information, see "Removing self-hosted runners." |
remove_topic | Triggered when a repository admin removes a topic from a repository. |
rename | Triggered when a repository is renamed. |
self_hosted_runner_online | Triggered when the runner application is started. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "Monitoring and troubleshooting self-hosted runners." |
self_hosted_runner_offline | Triggered when the runner application is stopped. Can only be viewed using the REST API; not visible in the UI or JSON/CSV export. For more information, see "Monitoring and troubleshooting self-hosted runners." |
self_hosted_runner_updated | Triggered when the runner application is updated. Can be viewed using the REST API and the UI; not visible in the JSON/CSV export. For more information, see "About self-hosted runners." |
set_actions_retention_limit | Triggered when the retention period for GitHub Actions artifacts and logs is changed. For more information, see "Managing GitHub Actions settings for a repository." |
set_fork_pr_workflows_policy | Triggered when the policy for workflows on private repository forks is changed. For more information, see "Managing GitHub Actions settings for a repository." |
staff_unlock | Triggered when an enterprise owner or GitHub Support (with permission from a repository administrator) temporarily unlocked the repository. The visibility of the repository isn't changed. |
transfer | Triggered when a repository is transferred. |
transfer_start | Triggered when a repository transfer is about to occur. |
unarchived | Triggered when a repository admin unarchives a repository. |
update_actions_secret | Triggered when a GitHub Actions secret is updated. |
repository_invitation
category actions
Action | Description |
---|---|
repository_invitation.accept | An invitation to join a repository was accepted. |
repository_invitation.cancel | An invitation to join a repository was canceled. |
repository_invitation.create | An invitation to join a repository was sent. |
repository_invitation.reject | An invitation to join a repository was declined. |
repository_secret_scanning
category actions
Action | Description |
---|---|
disable | Triggered when a repository owner or person with admin access to the repository disables secret scanning for a repository. For more information, see "About secret scanning." |
enable | Triggered when a repository owner or person with admin access to the repository enables secret scanning for a repository. |
repository_secret_scanning_custom_pattern
category actions
Action | Description |
---|---|
create | Triggered when a custom pattern is created for secret scanning in a repository. For more information, see "Defining custom patterns for secret scanning." |
delete | Triggered when a custom pattern is removed from secret scanning in a repository. For more information, see "Defining custom patterns for secret scanning." |
publish | Triggered when a custom pattern is published for secret scanning in a repository. For more information, see "Defining custom patterns for secret scanning." |
update | Triggered when changes to a custom pattern are saved and a dry run is executed for secret scanning in a repository. For more information, see "Defining custom patterns for secret scanning." |
repository_secret_scanning_push_protection
category actions
Action | Description |
---|---|
disable | Triggered when a repository owner or person with admin access to the repository disables secret scanning for a repository. For more information, see "Protecting pushes with secret scanning." |
enable | Triggered when a repository owner or person with admin access to the repository enables secret scanning for a repository. |
repository_vulnerability_alert
category actions
Action | Description |
---|---|
create | Triggered when GitHub Enterprise Server creates a Dependabot alert for a repository that uses a vulnerable dependency. For more information, see "About Dependabot alerts." |
dismiss | Triggered when an organization owner or person with admin access to the repository dismisses a Dependabot alert about a vulnerable dependency. |
resolve | Triggered when someone with write access to a repository pushes changes to update and resolve a vulnerability in a project dependency. |
role
category actions
Action | Description |
---|---|
create | Triggered when an organization owner creates a new custom repository role. For more information, see "Managing custom repository roles for an organization." |
destroy | Triggered when an organization owner deletes a custom repository role. For more information, see "Managing custom repository roles for an organization." |
update | Triggered when an organization owner edits an existing custom repository role. For more information, see "Managing custom repository roles for an organization." |
secret_scanning
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables secret scanning for all existing repositories. For more information, see "About secret scanning." |
enable | Triggered when an organization owner enables secret scanning for all existing repositories. |
secret_scanning_new_repos
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables secret scanning for all new repositories. For more information, see "About secret scanning." |
enable | Triggered when an organization owner enables secret scanning for all new repositories. |
team
category actions
Action | Description |
---|---|
add_member | Triggered when a member of an organization is added to a team. |
add_repository | Triggered when a team is given control of a repository. |
change_parent_team | Triggered when a child team is created or a child team's parent is changed. |
change_privacy | Triggered when a team's privacy level is changed. |
create | Triggered when a new team is created. |
demote_maintainer | Triggered when a user was demoted from a team maintainer to a team member. For more information, see "Assigning the team maintainer role to a team member." |
destroy | Triggered when a team is deleted from the organization. |
promote_maintainer | Triggered when a user is promoted from a team member to a team maintainer. For more information, see "Assigning the team maintainer role to a team member." |
remove_member | Triggered when a member of an organization is removed from a team. |
remove_repository | Triggered when a repository is no longer under a team's control. |
team_discussions
category actions
Action | Description |
---|---|
disable | Triggered when an organization owner disables team discussions for an organization. For more information, see "Disabling team discussions for your organization." |
enable | Triggered when an organization owner enables team discussions for an organization. |
workflows
category actions
Action | Description |
---|---|
cancel_workflow_run | Triggered when a workflow run has been cancelled. For more information, see "Canceling a workflow." |
completed_workflow_run | Triggered when a workflow status changes to completed . Can only be viewed using the REST API; not visible in the UI or the JSON/CSV export. For more information, see "Viewing workflow run history." |
created_workflow_run | Triggered when a workflow run is created. Can only be viewed using the REST API; not visible in the UI or the JSON/CSV export. For more information, see "Understanding GitHub Actions." |
delete_workflow_run | Triggered when a workflow run is deleted. For more information, see "Deleting a workflow run." |
disable_workflow | Triggered when a workflow is disabled. |
enable_workflow | Triggered when a workflow is enabled, after previously being disabled by disable_workflow . |
rerun_workflow_run | Triggered when a workflow run is re-run. For more information, see "Re-running workflows and jobs." |
prepared_workflow_job | Triggered when a workflow job is started. Includes the list of secrets that were provided to the job. Can only be viewed using the REST API. It is not visible in the GitHub web interface or included in the JSON/CSV export. For more information, see "Events that trigger workflows." |
approve_workflow_job | Triggered when a workflow job has been approved. For more information, see "Reviewing deployments." |
reject_workflow_job | Triggered when a workflow job has been rejected. For more information, see "Reviewing deployments." |