v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBSecurity Monitoring
Attach security findings to a Jira issue
Attach security findings to a Jira issue by providing the Jira issue URL. You can attach up to 50 security findings per Jira issue. If the Jira issue is not linked to any case, this operation will create a case for the security findings and link the Jira issue to the newly created case. To configure the Jira integration, see Bidirectional ticket syncing with Jira. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the specified Jira issue.
patch/api/v2/security/findings/jira_issues
Request body
Example request
{
"data": {
"attributes": {
"jira_issue_url": "https://domain.atlassian.net/browse/PROJ-123"
},
"relationships": {
"findings": {
"data": [
{
"id": "ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw==",
"type": "findings"
}
]
},
"project": {
"data": {
"id": "aeadc05e-98a8-11ec-ac2c-da7ad0900001",
"type": "projects"
}
}
},
"type": "jira_issues"
}
}Response
OK
Example response
{
"data": {
"attributes": {
"archived_at": "2025-01-01T00:00:00.000Z",
"assigned_to": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"closed_at": "2025-01-01T00:00:00.000Z",
"created_at": "2025-01-01T00:00:00.000Z",
"creation_source": "CS_SECURITY_FINDING",
"description": "A description of the case.",
"due_date": "2025-01-01",
"insights": [
{
"ref": "/security/appsec/vm/library/vulnerability/dfa027f7c037b2f77159adc027fecb56?detection=static",
"resource_id": "ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw==",
"type": "SECURITY_FINDING"
}
],
"jira_issue": {
"error_message": "{\"errorMessages\":[\"An error occured.\"],\"errors\":{}}",
"result": {
"account_id": "463a8631-680e-455c-bfd3-3ed04d326eb7",
"issue_id": "2871276",
"issue_key": "PROJ-123",
"issue_url": "https://domain.atlassian.net/browse/PROJ-123"
},
"status": "COMPLETED"
},
"key": "PROJ-123",
"linear_issue": {
"error_message": "Linear issue creation failed.",
"result": {
"account_id": "463a8631-680e-455c-bfd3-3ed04d326eb7",
"issue_id": "9c1e5f8a-2b3d-4c7e-8f6a-1d2e3f4a5b6c",
"issue_key": "ENG-123",
"team_id": "b5d3c8a1-7e6f-4d2c-9a8b-3c4d5e6f7a8b",
"url": "https://linear.app/your-workspace/issue/ENG-123"
},
"status": "COMPLETED"
},
"modified_at": "2025-01-01T00:00:00.000Z",
"priority": "P4",
"servicenow_ticket": {
"result": {
"instance_name": "example",
"sys_id": "abcdef0123456789abcdef0123456789",
"sys_target_link": "https://example.service-now.com/incident.do?sys_id=abcdef0123456789abcdef0123456789",
"sys_target_sys_id": "abcdef0123456789abcdef0123456789",
"table_name": "incident",
"url": "https://example.service-now.com/now/nav/ui/classic/params/target/incident.do?sys_id=abcdef0123456789abcdef0123456789"
},
"status": "COMPLETED"
},
"status": "OPEN",
"status_group": "SG_OPEN",
"status_name": "Open",
"title": "A title for the case.",
"type": "SECURITY"
},
"id": "c1234567-89ab-cdef-0123-456789abcdef",
"relationships": {
"created_by": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"modified_by": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"project": {
"data": {
"id": "aeadc05e-98a8-11ec-ac2c-da7ad0900001",
"type": "projects"
}
}
},
"type": "cases"
}
}