Sign in

v1

latestOpenAPI 3.0.32026-07-22238629559.2 KB
TicketingService

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. Requires a configured ticketing integration.

post/api/v1/deployments/{deploymentId}/tickets/link

Path parameters

deploymentIdstring required

Deployment ID. Can be found at /deployments, or in your Settings in the web UI.

Request body

deploymentIdstring

Deployment ID. Can be found at /deployments, or in your Settings in the web UI.

issue_idsstring[] required

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

ticket_urlstring required

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

Example request

{
  "issue_ids": [
    123,
    456
  ],
  "ticket_url": "https://myorg.atlassian.net/browse/SEC-123"
}

Response

OK

external_slugstring

The external slug identifier for the ticket (e.g. SEC-123)

linked_issue_idsstring[]

List of finding IDs that were successfully linked to the ticket

replaced_issue_idsstring[]

List of finding IDs where an existing ticket link was replaced

ticket_idinteger

The internal ID of the linked ticket record

ticket_urlstring

The URL of the linked ticket