Create Task
Create a task and assign to a user.
Implementation | System |
Command Category | System Utility |
Tags | INCIDENT INCIDENT TASK |
Inputs
Parameter Name | Required/Optional | Description | Sample Data |
---|---|---|---|
Task Name | Optional | The task name. |
|
Task Type | Optional | Ad Hoc Task Type |
|
Task Description | Optional | The task description. |
|
Assignee | Optional | The user who is assigned to the task. |
|
Due Date | Optional | Due date of the task. |
|
Required | Optional | Assigned user must complete this task to close the incident. |
|
Incident Number | Optional | The Incident number of the create task |
|
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/CreateTask
Headers
Please refer to the page Webhook Configuration Guide - Authentication Method: API Keys for more details.
Request Body
{
"Username": "Admin",
"Site": "Security Operations",
"CommandParams": {
"Task Name": "Sample Task ",
"Task Type": "Default",
"Task Description": "Sample Task Description",
"Assignee": "admin user",
"Due Date": "2022-03-24 13:28:13",
"Required": "Yes",
"Incident Number": "20220125-1"
}
}
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. |
Task Name |
| Optional | The task name. |
Task Type |
| Optional | Ad Hoc Task Type |
Task Description |
| Optional | The task description. |
Assignee |
| Optional | The user who is assigned to the task. |
Due Date |
| Optional | Due date of the task. |
Required |
| Optional | Assigned user must complete this task to close the incident. |
Incident Number |
| Optional | The Incident number of the create task |
Sample Request
SAMPLE DATA
{
"Username": "Admin",
"Site": "Security Operations",
"CommandParams": {
"Task Name": "Sample Task ",
"Task Type": "Default",
"Task Description": "Sample Task Description",
"Assignee": "admin user",
"Due Date": "2022-03-24 13:28:13",
"Required": "Yes",
"Incident Number": "20220125-1"
}
}
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. |
rawData |
| The raw data from the API request. |
Sample Response
{
"error": "",
"returnData": "Successful",
"rawData": {
"Task Name": "Sample Task",
"Task Type": "Default",
"Task Description": "<p>Sample Task Description</p>",
"Assignee": "admin user",
"Due Date": "2022-03-24 13:28:13 China Standard Time",
"Required on incident close": "Required",
"Creator": "admin user",
"Incident Number": "20220125-1"
}
}