1
0
mirror of synced 2026-01-06 06:02:35 -05:00
Files
docs/content/rest/secret-scanning.md
2022-04-28 16:59:56 +00:00

26 lines
1.3 KiB
Markdown

---
title: Secret scanning
intro: 'Use the Secret scanning API to retrieve and update secret alerts from a repository.'
versions:
ghes: '*'
ghae: '*'
ghec: '*'
topics:
- API
miniTocMaxHeadingLevel: 3
redirect_from:
- /rest/reference/secret-scanning
---
{% data reusables.secret-scanning.api-beta %}
## About the Secret scanning API
The {% data variables.product.prodname_secret_scanning %} API lets you{% ifversion fpt or ghec or ghes > 3.1 or ghae %}:
- Enable or disable {% data variables.product.prodname_secret_scanning %}{% if secret-scanning-push-protection %} and push protection{% endif %} for a repository. For more information, see "[Repositories](/rest/reference/repos#update-a-repository)" and expand the "Properties of the `security_and_analysis` object" section in the REST API documentation.
- Retrieve and update {% data variables.product.prodname_secret_scanning_GHAS %} alerts from a repository. For further details, see the sections below.
{%- else %} retrieve and update {% data variables.product.prodname_secret_scanning %} alerts from a repository.{% endif %}
For more information about {% data variables.product.prodname_secret_scanning %}, see "[About {% data variables.product.prodname_secret_scanning %}](/code-security/secret-security/about-secret-scanning)."