v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBSecurity Monitoring
Create Jira issues for security findings
Create Jira issues for security findings. This operation creates a case in Datadog and a Jira issue linked to that case for bidirectional sync between Datadog and Jira. To configure the Jira integration, see Bidirectional ticket syncing with Jira. You can create up to 50 Jira issues per request and associate up to 50 security findings per Jira issue. Security findings that are already attached to another Jira issue will be detached from their previous Jira issue and attached to the newly created Jira issue.
post/api/v2/security/findings/jira_issues
Request body
Example request
{
"data": [
{
"attributes": {
"assignee_id": "f315bdaf-9ee7-4808-a9c1-99c15bf0f4d0",
"description": "A description of the Jira issue.",
"fields": {
"key1": "value",
"key2": [
"value"
],
"key3": {
"key4": "value"
}
},
"priority": "NOT_DEFINED",
"title": "A title for the Jira issue."
},
"relationships": {
"findings": {
"data": [
{
"id": "ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw==",
"type": "findings"
}
]
},
"project": {
"data": {
"id": "aeadc05e-98a8-11ec-ac2c-da7ad0900001",
"type": "projects"
}
}
},
"type": "jira_issues"
}
]
}Response
Created
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"
}
]
}