alerts

Overview

Name	alerts
Type	Resource
Id	github.secret_scanning.alerts

Fields

Name	Datatype	Description
resolved_by	object	Simple User
locations_url	string	The REST API URL of the code locations for this alert.
state	string	Sets the state of the secret scanning alert. Can be either open or resolved. You must provide resolution when you set the state to resolved.
secret	string	The secret that was detected.
secret_type	string	The type of secret that secret scanning detected.
resolved_at	string	The time that the alert was resolved in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
number	integer	The security alert number.
resolution	string	Required when the state is resolved. The reason for resolving the alert. Can be one of false_positive, wont_fix, revoked, or used_in_tests.
created_at	string	The time that the alert was created in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
html_url	string	The GitHub URL of the alert resource.
url	string	The REST API URL of the alert resource.

Methods

Name	Accessible by	Required Params	Description
get_alert	SELECT	alert_number, owner, repo	Gets a single secret scanning alert detected in a private repository. To use this endpoint, you must be an administrator for the repository or organization, and you must use an access token with the repo scope or security_events scope. GitHub Apps must have the secret_scanning_alerts read permission to use this endpoint.
list_alerts_for_enterprise	SELECT	enterprise	Lists secret scanning alerts for eligible repositories in an enterprise, from newest to oldest. To use this endpoint, you must be a member of the enterprise, and you must use an access token with the repo scope or security_events scope. Alerts are only returned for organizations in the enterprise for which you are an organization owner or a security manager.
list_alerts_for_org	SELECT	org	Lists secret scanning alerts for eligible repositories in an organization, from newest to oldest. To use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the repo scope or security_events scope. GitHub Apps must have the secret_scanning_alerts read permission to use this endpoint.
list_alerts_for_repo	SELECT	owner, repo	Lists secret scanning alerts for a private repository, from newest to oldest. To use this endpoint, you must be an administrator for the repository or organization, and you must use an access token with the repo scope or security_events scope. GitHub Apps must have the secret_scanning_alerts read permission to use this endpoint.
update_alert	EXEC	alert_number, owner, repo, data__state	Updates the status of a secret scanning alert in a private repository. To use this endpoint, you must be an administrator for the repository or organization, and you must use an access token with the repo scope or security_events scope. GitHub Apps must have the secret_scanning_alerts write permission to use this endpoint.