Link Incidents to A New Case
Create a new case and link the provided incidents to it. If no incident number provided, link the current incident to the new case.
Implementation | System |
Command Category | System Utility |
Tags | INCIDENT INCIDENT LINKING |
Inputs
Parameter Name | Required/Optional | Description | Sample Data |
---|---|---|---|
Incident Numbers | Optional | The array of incident numbers of incidents which will be linked to a new case. |
CODE
|
Case Owner's Site | Optional | The owner's site of the new case. |
|
Case Reported Date | Optional | The reported date of the new case. |
|
Case Type | Optional | The case type of the new case. |
|
Case Lead Investigators | Optional | The lead investigator of the new case. |
|
Case Priority | Optional | The priority level of the new case. |
|
Case Timezone | Optional | The timezone of the new case. |
|
Copy Form Data | Optional | Whether or not to copy incidents' form data to the newly linked case. |
|
Username | Optional | The username of user that link incidents to a new case. This username will be used only when the task is run automatically. |
|
Output
Remote Command API
The D3 command API allows you to send requests to D3 SOAR to execute this utility command via REST API.
Request
POST
https:/{base_url}/{api_namespace}/api/Command/LinkIncidentsToNewCase
Headers
Please refer to the page Webhook Configuration Guide - Authentication Method: API Keys for more details.
Request Body
{
"Username": "<Username here>",
"Site": "<Site here>",
"CommandParams": {
"Incident Numbers": "<Incident Numbers here>",
"Case Owner's Site": "<Case Owner's Site here>",
"Case Reported Date": "<Case Reported Date here>",
"Case Type": "<Case Type here>",
"Case Lead Investigators": "<Case Lead Investigators here>",
"Case Priority": "<Case Priority here>",
"Case Timezone": "<Case Timezone here>",
"Copy Form Data": "<whether to Copy Form Data>",
"Username": "<Username here>"
}
}
Body Parameters
Parameter Name | Type | Required/Optional | Description |
---|---|---|---|
Username |
| Required | The username of your D3 SOAR account. |
Site |
| Required | The D3 SOAR site to run the remote command. |
Incident Numbers |
| Optional | The array of incident numbers of incidents which will be linked to a new case. |
Case Owner's Site |
| Optional | The owner's site of the new case. |
Case Reported Date |
| Optional | The reported date of the new case. |
Case Type |
| Optional | The case type of the new case. |
Case Lead Investigators |
| Optional | The lead investigator of the new case. |
Case Priority |
| Optional | The priority level of the new case. |
Case Timezone |
| Optional | The timezone of the new case. |
Copy Form Data |
| Optional | Whether or not to copy incidents' form data to the newly linked case. |
Sample Request
SAMPLE DATA
{
"Username": "Admin",
"Site": "Security Operations",
"CommandParams": {
"Incident Numbers": [
"20210330-180",
"20210330-181"
],
"Case Owner's Site": "Security Operations",
"Case Reported Date": "2021-01-26 00:00:00",
"Case Type": "Criminal Investigation",
"Case Lead Investigators": "admin user",
"Case Priority": "3",
"Case Timezone": "(GMT-08:00) Pacific Standard Time",
"Copy Form Data": "Yes",
"Username": "admin user"
}
}
Response
Response Fields
Field Name | Type | Description |
---|---|---|
error |
| The error message if the API request has failed. |
returnData |
| The return data from the API request. |
contextData |
| The context data from the API request. |
Sample Response
{
"error": "",
"returnData": "20210330-16",
"contextData": [
{
"IncidentNumber": "20210330-180",
"LinkedCaseNumber": "20210330-16",
"UpdatedForm": [
{
"ID": 223,
"Name": "ABC 01"
},
{
"ID": 1112,
"Name": "MySection"
}
]
},
{
"IncidentNumber": "20210330-181",
"LinkedCaseNumber": "20210330-16",
"UpdatedForm": [
{
"ID": 223,
"Name": "ABC 01"
},
{
"ID": 1112,
"Name": "MySection"
}
]
}
]
}