latestOpenAPI 3.0.3GitGuardian2026-08-201871515.0 MB

511b067cdcb1

Sources

Trigger scans on sources

⚠️ Beta Version: This endpoint is in beta and may be subject to changes in future releases.

Trigger historical scans for a list of source IDs. The scans are dispatched asynchronously; this endpoint returns immediately with a 202 Accepted status.

Behavior:

  • Both monitored and unmonitored sources can be scanned.

⚠️ The following sources will be silently skipped (no error returned):

  • Sources whose ID does not exist or does not belong to the workspace.
  • Sources that are disabled.
  • Sources that already have a scan in progress.
  • Sources that are not scannable by the current account plan (e.g. business-only integrations on a free plan).
  • All sources are skipped if the workspace scan quota is exhausted.

Tracking progress: Use GET /v1/sources/{source_id} to check the last_scan status of each source.

If you are using a personal access token, you need to have an access level greater or equal to manager.

post/v1/sources/scans

Request body

source_idsinteger[] required

List of source IDs to scan.

Example request

{
  "source_ids": [
    1,
    2,
    3
  ]
}

Response

Accepted – scans have been queued.