GET /orgs/{org}/dependabot/alerts
Lists Dependabot alerts for an organization.
The authenticated user must be an owner or security manager for the organization to use this endpoint.
OAuth app tokens and personal access tokens (classic) need the security_events
scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public_repo
scope instead.
Servers
- https://api.github.com
Path parameters
Name | Type | Required | Description |
---|---|---|---|
org |
String | Yes |
The organization name. The name is not case sensitive. |
Query parameters
Name | Type | Required | Description |
---|---|---|---|
sort |
String | No |
The property by which to sort the results.
Possible values:
Default value: "created" |
scope |
String | No |
The scope of the vulnerable dependency. If specified, only alerts with this scope will be returned. Possible values:
|
first |
Integer | No |
Deprecated. The number of results per page (max 100), starting from the first matching result.
This parameter must not be used in combination with Default value: 30 |
state |
String | No |
A comma-separated list of states. If specified, only alerts with these states will be returned. Can be: |
epss_percentage |
String | No |
CVE Exploit Prediction Scoring System (EPSS) percentage. Can be specified as:
Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. |
before |
String | No |
A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API." |
severity |
String | No |
A comma-separated list of severities. If specified, only alerts with these severities will be returned. Can be: |
ecosystem |
String | No |
A comma-separated list of ecosystems. If specified, only alerts for these ecosystems will be returned. Can be: |
direction |
String | No |
The direction to sort the results by. Possible values:
Default value: "desc" |
after |
String | No |
A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API." |
per_page |
Integer | No |
The number of results per page (max 100). For more information, see "Using pagination in the REST API." Default value: 30 |
last |
Integer | No |
Deprecated. The number of results per page (max 100), starting from the last matching result.
This parameter must not be used in combination with |
package |
String | No |
A comma-separated list of package names. If specified, only alerts for these packages will be returned. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.