<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs
Change Task Worklog
This API helps you to track and record the work done by a team member.
Attributes
id (long)
Indicates the unique ID of the Worklog
owner (user)
Indicates the owner for the worklog
description (html)
Contains a description about the worklog
start_time (datetime)
Indicates the start date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
end_time (datetime)
Contains the end date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
recorded_time (datetime)
Contains the creation date and time of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
More Attributes Expand all
Add Change Task Worklog
This operation helps you to add a worklog for a change task.
Mandatory Fields :- owner
Url
Attributes
id (long)
Indicates the unique ID of the Worklog
owner (user)
Indicates the owner for the worklog
description (html)
Contains a description about the worklog
start_time (datetime)
Indicates the start date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
end_time (datetime)
Contains the end date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
recorded_time (datetime)
Contains the creation date and time of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
More Attributes Expand all
$ curl <service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs\
-X POST\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"\
-d input_data='{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629964757165"
},
"time_spent": {
"hours": "4",
"minutes": 0
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629964757165"
},
"time_spent": {
"hours": "4",
"minutes": 0
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
};
params = {"input_data": input_data};
response = invokeurl
[
url: url
type: POST
parameters: params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629964757165"
},
"time_spent": {
"hours": "4",
"minutes": 0
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629964757165"
},
"time_spent": {
"hours": "4",
"minutes": 0
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": {
"status_code": 2000,
"status": "success"
},
"worklog": {
"owner": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"cost_per_hour": "0.0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=10&ID=12&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"include_nonoperational_hours": true,
"end_time": {
"display_value": "Aug 26, 2021 01:29 PM",
"value": "1629964757165"
},
"description": "",
"other_charge": "0",
"total_charge": "0",
"created_by": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=10&ID=2&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"recorded_time": {
"display_value": "Aug 26, 2021 01:29 PM",
"value": "1629964778227"
},
"time_spent": {
"hours": "04",
"minutes": "00",
"value": "14400000"
},
"tech_charge": "0",
"start_time": {
"display_value": "Aug 26, 2021 09:29 AM",
"value": "1629950357165"
},
"worklog_type": null,
"id": "2000000033617"
}
}
Edit Change Task Worklog
This operation helps you to update a worklog for a change task.
Url
<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617
Attributes
id (long)
Indicates the unique ID of the Worklog
owner (user)
Indicates the owner for the worklog
description (html)
Contains a description about the worklog
start_time (datetime)
Indicates the start date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
end_time (datetime)
Contains the end date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
recorded_time (datetime)
Contains the creation date and time of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
More Attributes Expand all
$ curl <service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617\
-X PUT\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"\
-d input_data='{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629979157165"
},
"time_spent": {
"hours": "08",
"minutes": "00"
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629979157165"
},
"time_spent": {
"hours": "08",
"minutes": "00"
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
};
params = {"input_data": input_data};
response = invokeurl
[
url: url
type: PUT
parameters: params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629979157165"
},
"time_spent": {
"hours": "08",
"minutes": "00"
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
"worklog": {
"owner": {
"id": "2000000033133"
},
"description": "",
"start_time": {
"value": "1629950357165"
},
"end_time": {
"value": "1629979157165"
},
"time_spent": {
"hours": "08",
"minutes": "00"
},
"tech_charge": "0.00",
"other_charge": "0",
"worklog_type": null,
"include_nonoperational_hours": true,
"mark_first_response": false
}
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": {
"status_code": 2000,
"status": "success"
},
"worklog": {
"owner": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"cost_per_hour": "0.0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=17&ID=12&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"include_nonoperational_hours": true,
"end_time": {
"display_value": "Aug 26, 2021 05:29 PM",
"value": "1629979157165"
},
"description": "",
"other_charge": "0",
"total_charge": "0",
"created_by": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=16&ID=112&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"recorded_time": {
"display_value": "Aug 26, 2021 01:29 PM",
"value": "1629964778227"
},
"time_spent": {
"hours": "08",
"minutes": "00",
"value": "28800000"
},
"tech_charge": "0",
"start_time": {
"display_value": "Aug 26, 2021 09:29 AM",
"value": "1629950357165"
},
"worklog_type": null,
"id": "2000000033617"
}
}
Get Change Task Worklog
This operation helps you to get a worklog for a change task.
Url
<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617
Attributes
id (long)
Indicates the unique ID of the Worklog
owner (user)
Indicates the owner for the worklog
description (html)
Contains a description about the worklog
start_time (datetime)
Indicates the start date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
end_time (datetime)
Contains the end date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
recorded_time (datetime)
Contains the creation date and time of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
More Attributes Expand all
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617\
-X GET\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
url: url
type: GET
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs/2000000033617"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": {
"status_code": 2000,
"status": "success"
},
"worklog": {
"owner": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"cost_per_hour": "0.0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=5&ID=19&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"include_nonoper
Get List Change Task Worklog
This operation helps you to get all worklogs for change task.
Url
<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs
Attributes
id (long)
Indicates the unique ID of the Worklog
owner (user)
Indicates the owner for the worklog
description (html)
Contains a description about the worklog
start_time (datetime)
Indicates the start date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
end_time (datetime)
Contains the end date and time of the worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
recorded_time (datetime)
Contains the creation date and time of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format
More Attributes Expand all
$ curl -G <service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs\
-X GET\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"\
--data-urlencode input_data='{}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {};
params = {"input_data":input_data};
response = invokeurl
[
url: url
type: GET
parameters:params
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{}'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/tasks/2000000033602/worklogs"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": [
{
"status_code": 2000,
"status": "success"
}
],
"list_info": {
"has_more_rows": false,
"row_count": 1
},
"worklogs": [
{
"owner": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=10&ID=112&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"include_nonoperational_hours": true,
"end_time": {
"display_value": "Aug 26, 2021 05:29 PM",
"value": "1629979157165"
},
"description": "",
"other_charge": "0",
"total_charge": "0",
"created_by": {
"email_id": "ad-360@zylker.com",
"is_technician": true,
"sms_mail": null,
"mobile": null,
"last_name": "",
"user_scope": "0",
"phone": null,
"name": "Bruce",
"id": "2000000033133",
"photo_url": "https://contacts.zylker.com/file?exp=10&ID=11&t=user&height=60&width=60",
"is_vip_user": false,
"department": null,
"first_name": "Bruce",
"job_title": null
},
"recorded_time": {
"display_value": "Aug 26, 2021 01:29 PM",
"value": "1629964778227"
},
"time_spent": {
"hours": "08",
"minutes": "00",
"value": "28800000"
},
"tech_charge": "0",
"start_time": {
"display_value": "Aug 26, 2021 09:29 AM",
"value": "1629950357165"
},
"worklog_type": null,
"id": "2000000033617"
}
]
}
Delete Change Task Worklog
This operation helps you to delete a worklog for a change task.
Url
<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/worklogs/2000000033617
$ curl <service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/worklogs/2000000033617\
-X DELETE\
-H "Accept: application/vnd.manageengine.sdp.v3+json"\
-H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
-H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/worklogs/2000000033617";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
url: url
type: DELETE
headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/worklogs/2000000033617"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
"Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
"Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request
url = "<service domain|custom domain>/app/<portal>/api/v3/changes/2000000033487/worklogs/2000000033617"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json",
"Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx",
"Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
with urlopen(httprequest) as response:
print(response.read().decode())
except HTTPError as e:
print(e.read().decode())
{
"response_status": {
"status_code": 2000,
"status": "success"
}
}