v1

latestOpenAPI 3.0.32026-07-22238629559.2 KB
ExternalTicketingService

Link an Existing Ticket to Findings

Link an existing external ticket (e.g. Jira) to one or more Semgrep findings by providing the ticket URL and a list of finding IDs. This does not create a ticket in your issue tracker — it only records the association in Semgrep. If a finding is already linked to a different ticket, the existing link is replaced.

post/api/notifications/deployments/{deploymentId}/ticketing/v2/{ticketingInstanceId}/tickets/link

Path parameters

deploymentIdinteger required

The unique numerical identifier of the deployment associated with the finding. Can be found via the Deployments Service or in your Settings in the web UI.

Example:1234
ticketingInstanceIdinteger required

The unique numerical identifier of the ticketing instance. Can be found via the Get External Ticketing Instances endpoint.

Example:5678

Request body

ticketUrlstring

The URL of the external ticket to link (e.g. https://myorg.atlassian.net/browse/SEC-123).

issueIdsinteger[]

An array of Semgrep finding IDs to link the ticket to.

Response

OK

ticketIdinteger
ticketUrlstring
externalSlugstring
linkedIssueIdsinteger[]
replacedIssueIdsinteger[]