Get a secret scanning alert
Get one secret scanning alert by id (sec_…), with every place it was found, its activity, its bypass requests, and whether you may bypass it or only ask to.
GET
/repos/{owner}/{name}/secret-scanning/alerts/{id}- Authentication: Required. Send an access token as
Authorization: Bearer. - MCP tool:
securitywithactionsecret_alert, and the same inputs - Scope: An access token needs
security:read.
Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
owner |
string | Yes | The workspace that owns the repository. |
name |
string | Yes | The repository’s name. |
id |
string | Yes | The alert’s id: sec_… |
Example request
Section titled “Example request”curl https://api.g1t.sh/repos/flagon-io/hello/secret-scanning/alerts/sec_01kq2m7d4e5f6g7h8j9k0m1n2p \ -H "Authorization: Bearer $G1T_TOKEN"Example response
Section titled “Example response”A successful request answers 200 with:
{ "secret": { "id": "sec_01kq2m7d4e5f6g7h8j9k0m1n2p", "repo_id": "rep_01kp0a1b2c3d4e5f6g7h8j9k0m", "kind": "github_token", "label": "a GitHub token", "path": "scripts/release.sh", "line": 12, "commit": "4807077b296e6edbf410d55e72749d3e1170c291", "preview": "ghp_X7…", "status": "blocked", "source": "push", "found_by": "syntaqx", "found_at": "2026-10-06T09:14:02.118Z", "decided_by": null, "reason": null, "decided_at": null, "dismissed_reason": null, "test_value": null, "state": "open", "validity": null, "validity_checked_at": null, "bypass": null, "pattern_id": null, "pattern_name": null, "locations": 1 }, "locations": [ { "path": "scripts/release.sh", "line": 12, "commit": "4807077b296e6edbf410d55e72749d3e1170c291", "source": "push", "found_at": "2026-10-06T09:14:02.118Z" } ], "activity": [], "requests": [], "checkable": true, "can_bypass": true, "can_request_bypass": false}Errors
Section titled “Errors”A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.
| Status | Code | When |
|---|---|---|
| 401 | unauthenticated |
A token is required, or the one sent is not valid. |
| 403 | forbidden |
The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository. |
| 404 | not_found |
It does not exist, or you cannot see it. |
| 422 | invalid |
The input is not valid. message says which field and why. |