# incidence

<div id="bkmrk-%60%60%60html">```html </div> <span>Add Task API Documentation</span>

 <span>After receiving the access token from the OAuth API, use the Add Task API to create a new Task or Incident.</span>

 <span>ACC Endpoint</span>

 [ https://acc.bzctrl.com/bzctrl-core-api/api/v1/task/add-task ](https://acc.bzctrl.com/bzctrl-core-api/api/v1/task/add-task)

 <button style="padding:8px 14px;cursor:pointer;"> Copy URL </button>

 <span>Production Endpoint</span>

 [ https://www.bzctrl.com/bzctrl-core-api/api/v1/task/add-task ](https://www.bzctrl.com/bzctrl-core-api/api/v1/task/add-task)

 <button style="padding:8px 14px;cursor:pointer;"> Copy URL </button>

 <span>Request Method</span>

 <span>POST</span>

 <span>Required Headers</span>

 <span> Content-Type: application/json  
 Authorization: Bearer {access\_token} </span>

 <span>Sample Request Body</span>

 <span> {  
 "todoType":"TASK",  
 "domainWorkSpace":"VTT-NLD-TML-FIN",  
 "title":"title",  
 "description":"description",  
 "result":"result",  
 "financialImpact":"123",  
 "impact":"HIGH",  
 "likelihood":"MEDIUM",  
 "status":"TODO",  
 "priority":"HIGH",  
 "assignee":"rge@vtti.com",  
 "reporter":"user@vtti.com",  
 "category":\["Customs","Fetsa"\],  
 "subCategory":\["high"\],  
 "lrn":"test",  
 "orderID":"tag",  
 "reminderDate":"2024-09-27"  
 } </span>

 <span>Field Reference</span>

 <span>**domainWorkSpace** - Workspace value from URL (Example: VTT-BEL-ATP)</span>

 <span>**todoType** - TASK, INCIDENT (must be uppercase)</span>

 <span>**status** - TODO, INPROGRESS, DONE</span>

 <span>**priority** - LOW, MEDIUM, HIGH</span>

 <span>**impact** - LOW, MEDIUM, HIGH</span>

 <span>**likelihood** - LOW, MEDIUM, HIGH</span>

 <span>**assignee** - Valid email address (Example: rge@vtti.com)</span>

 <span>**reporter** - Valid email address (Example: user@vtti.com)</span>

 <span>**reminderDate** - Format YYYY-MM-DD</span>

 <span>Allowed Values</span>

 <span> todoType: TASK, INCIDENT  
  
 status: TODO, INPROGRESS, DONE  
  
 priority: LOW, MEDIUM, HIGH  
  
 impact: LOW, MEDIUM, HIGH  
  
 likelihood: LOW, MEDIUM, HIGH </span>

 <span>Sample Response</span>

 <span> {  
 "title":"Potential Customs claim",  
 "taskType":"INCIDENT",  
 "description":"Operation started without proper approvals",  
 "taskLink":"https://www.bzctrl.com/app/#/todo/IMP-NLD-EXA-SWA-03",  
 "tags":\["SO 777"\]  
 } </span>

 <span>Note: The access token received from the OAuth Token API must be included in the Authorization header using the Bearer scheme.</span>

<div id="bkmrk-%60%60%60">``` </div>