V2
| API | SaveSubTaskData |
| Purpose | To save the ticket details for the Sub-Task management Module. |
| API URL | https://<API URL>:<API Port>//v2/sub-task/orgentityid/{orgentityid} |
| Authentication type | Basic /Token |
| Method Type | Post |
If “IsTimeZoneOrOffset”: “TIMEZONE” then it is mandatory to define the time zone in which the ticket is being created in the key “TimeZone” and “TimeZoneOffset” value can be left blank else if “IsTimeZoneOrOffset”: “OFFSET“ then it is mandatory to define the offset value in the key “TimeZoneOffset” and “TimeZone” value can be left blank else if “IsTimeZoneOrOffset” : “GMT” then no need to define the value for keys “TimeZone” and“TimeZoneOffset” and can be left blank. (Offset value is the difference of time in minutes in which the ticket is being created and GMT time.)
Request Format:
[
{
"TicketNumber": "string",
"Summary": "string",
"Sys_id": "string",
"ResolvedDate": "string",
"AssignedGroup": "string",
"StatusCode": "string",
"CreationDate": "string",
"Description": "string",
"LastModifiedDate": "string",
"Col1": "string",
"Col2": "string",
"Col3": "string",
"Col4": "string",
"Col5": "string",
"Col6": "string",
"Col7": "string",
"Col8": "string",
"Col9": "string",
"TimeZone": "string",
"TimeZoneOffset": "string",
"IsTimeZoneOrOffset": "string",
"IsEpoch": "string",
"Priority": "string"
}
]Parameters Required in Request body of API
| Column | Column Type | Mandatory | Expected/Sample value | Remarks |
|---|---|---|---|---|
| TicketNumber | String | Yes | XXXXXXXX | This field contains ticket number |
| Summary | String | Yes | testing | This field contains summary of ticket |
| Sys_id | String | Yes | XXXXXXXX | This field contains unique number |
| ResolvedDate | String | No | 2019-11-18 07:24:52 | This field contains date whenever ticket gets resolved |
| AssignedGroup | String | No | XXXXXXXXX | This field contains assignment group of ticket |
| StatusCode | String | Yes | 1 | This field contains status of ticket |
| CreationDate | String | Yes | 2019-11-18 06:24:52 | This field contains creation date of ticket |
| Description | String | Yes | testing | This field contains summary of ticket |
| LastModifiedDate | String | Yes | 2019-11-18 07:24:52 | This field contains date whenever updating happen on ticket |
| Col1 | String | No | You can use it for any custom value | |
| Col2 | String | No | You can use it for any custom value | |
| Col3 | String | No | You can use it for any custom value | |
| Col4 | String | No | You can use it for any custom value | |
| Col5 | String | No | You can use it for any custom value | |
| TimeZone | String | Value is Mandatory if "IsTimeZoneOrOffset":"TIMEZONE" | IST | It defines in which format you are sending data, in use only when "IsTimeZoneOrOffset":"TIMEZONE" |
| TimeZoneOffset | String | Value is Mandatory if "IsTimeZoneOrOffset":"OFFSET" | -330 | It defines he offset, in use only when "IsTimeZoneOrOffset":"OFFSET" |
| IsTimeZoneOrOffset | String | Yes | TIMEZONE/ OFFSET/ GMT | It defines whether you want to use Timezone, offset or GMT value |
| IsEpoch | String | Yes | Y or N | If date format is Epoch, set this key value as "Y" else "N" |
| ModuleId | String | Yes | 1or 9 | ModuleId=1 for Incident Management and ModuleId=9 for Event Management |
Output:
{
"Id": " XXXXXXXX ",
"Status": "Success",
"Message": "Sub Task data saved successfully”.
}Parameter Returned in API result
| Column | Column type | Value | Remarks |
|---|---|---|---|
| Id | string | 1017ae8a-f01e-439c-988a-7d91dba6c157 | Reference Number |
| Status | string | Success/Fail | Status of the API call |
| Message | string | Message | Details about the API call result |