V1

Save Change Request Task Data

API SaveChangeRequestTaskData
Purpose To save the ticket details for Change Tasks.
API URL https://<API URL>:<API Port>//iAutomateAPI/Request/SaveChangeRequestTaskData/1
Authentication type Basic
Method Type Post

Request Format:

{
"TicketNumber": "XXXXXXXX ",
"Summary": "testing",
"sys_id": "XXXXXXXX ",
"ChangeId": "XXXXXXXX ",
"StatusCode": "1",
"CreationDate": "2019-11-18 06:24:54",
"Description": "testing data",
"LastModifiedDate": "2019-11-18 06:24:54",
"AssignedGroup":"XXXXXXXX ",
 "Col1": " ",
 "Col2": " ",
 "Col3": " ",
 "Col4": " ",
 "Col5": " ",
"TimeZone": "IST",
"TimeZoneOffset":"-330",
"IsTimeZoneOrOffset": "TIMEZONE/OFFSET/GMT",
"IsEpoch": "N"
 }

Parameters Required in Request Body of API

Column Column Type Mandatory Expected/Sample value Remarks
TicketNumber String Yes XXXXXXXX This field contains change task number
Summary String Yes testing This field contains summary of change task
sys_id String Yes XXXXXXXX This field contains unique number
changeid String Yes XXXXXXXX This field contains unique number of changes
StatusCode String Yes 1 This field contains status of change task
CreationDate String Yes 2019-11-18 06:24:52 This field contains creation date of change task
Description String Yes testing This field contains summary of change task
LastModifiedDate String Yes 2019-11-18 07:24:52 This field contains date whenever updating happen on change task
AssignedGroup String No XXXXXXXX This field contains assignment group of change task
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"

Output:

{
 "statusCode": 200,
 "status": "Success",
 "message": "Success",
 “result": "XXXXXXXX "
}

Parameters Returned in Response of API

Column Column type Value Remarks
StatusCode int
  • Success = 200,
  • Error = 300,
  • RequiredAttributeValueMissing = 400,
  • Unauthorized = 401,
This field provide status code
Status string Success/Fail This field provide status
Message string null or message in case of not success
Result string XXXXXXXX This field provide unique number for reference