git.security.set-dependency-alertDismiss a dependency alert with a reason, or reopen it
Request syntax
PATCH /git/api/repositories/{repoId}/security/dependency-alerts/{alertId}
{
"state": "enum",
"reason": "string",
"comment": "string"
}Path parameters
repoIdRequiredstring
Constraints: uuid
alertIdRequiredstring
Constraints: uuid
Request body
stateRequiredenum
`dismissed` closes the alert, `open` reopens it
One of:
open,dismissedreasonOptionalstring
Why it is dismissed: false positive, not exploitable, accepted risk, fix later, or your own words
Constraints: max 2000 chars
commentOptionalstring
Your own words beside the reason
Constraints: max 2000 chars
Response
200 with the alert in its new state, with dismissedReason and dismissedComment.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
idAlwaysstring
The alertorgIdAlwaysstring
The organizationrepoIdAlwaysstring
The repositorystateAlwaysone of open, fixed, dismissed
fixed once a scan no longer finds the vulnerable versionmanifestPathAlwaysstring
The lockfile the package is installed byecosystemAlwaysstring
The package ecosystem, e.g. npmpackageNameAlwaysstring
The vulnerable packageinstalledVersionAlwaysstring
The version the lockfile installsfixedVersionAlwaysstring, may be null
The first version with the fix; null if none yetvulnerabilityIdAlwaysstring
The advisory id, e.g. GHSA-… or CVE-…severityAlwaysone of critical, high, medium, low, unknown
The severitytitleAlwaysstring
The advisory's titleurlAlwaysstring, may be null
A link to the advisory; null when it has nonecvssScoreAlwaysnumber, may be null
CVSS base score, 0 to 10; null when not publishedcvssVectorAlwaysstring, may be null
CVSS vector string; null when not publishedreferencesAlwaysarray of string
Links the advisory citesaliasesAlwaysarray of string
Other ids of the same advisorypublishedAtAlwaysstring, may be null
When the advisory was published (ISO 8601); null when unknownrelationshipAlwaysone of direct, indirect, may be null
direct: named in the manifest; indirect: pulled in by another package; null when unknownchainAlwaysarray of string
From a direct dependency down to this package, name@version eachdevAlwaysboolean, may be null
Only a development dependency; null when unknownlastSeenCommitOidAlwaysstring
The default-branch commit of the scan that last saw itdismissedReasonAlwaysstring, may be null
Why it was dismissed; null unless dismisseddismissedCommentAlwaysstring, may be null
Own words beside the reason; null unless givendismissedAtAlwaysstring, may be null
When it was dismissed (ISO 8601); null unless dismisseddismissedByIamUserIdAlwaysstring, may be null
Who dismissed it; null unless dismissedfixedAtAlwaysstring, may be null
When a scan found it fixed (ISO 8601); null until thencreatedAtAlwaysstring
When it was first found (ISO 8601)updatedAtAlwaysstring
When the alert last changed (ISO 8601)descriptionAlwaysstring, may be null
The advisory as published (Markdown); null for alerts found before it was kept
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow git:UpdateSecurityAlert on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud git security set-dependency-alert repoId alertId --state opencurl -X PATCH "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/security/dependency-alerts/alertId" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{"state":"open"}'Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_security_set-dependency-alert.