Skip to content

Release Task Worklog

This API helps you to track and record the work done by a team member in a task for the release module

Attributes

id (long)
Indicates the unique ID of the Worklog

id (long)
Numerical digits which are considered to have larger values.

Example 

234759602834500

owner (user)
Indicates the owner for the worklog

owner (user)
Indicates the owner for the worklog

Example 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_owner",
    "id": "100000000000042013"
  }
}

description (html)
Contains the description about the worklog

description (html)
HTML is a text area where html elements can be used.

Example 

<b>The content to be displayed</b>

start_time (datetime)
Contains 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

start_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

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

end_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

recorded_time (datetime)
Contains the date and time of creation of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format

recorded_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

other_charge (double)

Indicates the extra charges other than the technician charges

other_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

tech_charge (double)

Indicates the technician charges related to the worklog

tech_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

include_nonoperational_hours (boolean)

Indicates whether to include non-operational hours or not

include_nonoperational_hours (boolean)
Boolean value which can have two possible values. The values are true and false.

mark_first_response (boolean)

Indicates whether to mark response date of a Request/ticket while adding worklog for that request/ticket

mark_first_response (boolean)
Boolean value which can have two possible values. The values are true and false.

worklog_type (worklog_type)

Indicates the different modes of technician’s work

worklog_type (worklog_type)
Indicates the different modes of technician’s work

Example 

{
  "worklog_type": {
    "name": "test_worklog_type",
    "id": "133333300000042011"
  }
}

created_by (user)read only

Indicates the user who created the worklog

created_by (user)
Indicates the user who created the worklog

Example 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

total_charge (double)read only

Indicates the total charges related to the worklog

total_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

time_spent (timediff)

Indicates the total time spent in the worklog in terms of hours, minutes and seconds

time_spent (timediff)
Indicates the total time spent in the worklog in terms of hours, minutes and seconds

Add Release Task Worklog

This operation helps to add a worklog for a release task.

Mandatory Fields :- owner

Url

/api/v3/releases/{release_id}/tasks/{task_id}/worklogs

Attributes

id (long)
Indicates the unique ID of the Worklog

id (long)
Numerical digits which are considered to have larger values.

Example 

234759602834500

owner (user)
Indicates the owner for the worklog

owner (user)
Indicates the owner for the worklog

Example 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_owner",
    "id": "100000000000042013"
  }
}

description (html)
Contains the description about the worklog

description (html)
HTML is a text area where html elements can be used.

Example 

<b>The content to be displayed</b>

start_time (datetime)
Contains 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

start_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

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

end_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

recorded_time (datetime)
Contains the date and time of creation of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format

recorded_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

other_charge (double)

Indicates the extra charges other than the technician charges

other_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

tech_charge (double)

Indicates the technician charges related to the worklog

tech_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

include_nonoperational_hours (boolean)

Indicates whether to include non-operational hours or not

include_nonoperational_hours (boolean)
Boolean value which can have two possible values. The values are true and false.

mark_first_response (boolean)

Indicates whether to mark response date of a Request/ticket while adding worklog for that request/ticket

mark_first_response (boolean)
Boolean value which can have two possible values. The values are true and false.

worklog_type (worklog_type)

Indicates the different modes of technician’s work

worklog_type (worklog_type)
Indicates the different modes of technician’s work

Example 

{
  "worklog_type": {
    "name": "test_worklog_type",
    "id": "133333300000042011"
  }
}

created_by (user)read only

Indicates the user who created the worklog

created_by (user)
Indicates the user who created the worklog

Example 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

total_charge (double)read only

Indicates the total charges related to the worklog

total_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

time_spent (timediff)

Indicates the total time spent in the worklog in terms of hours, minutes and seconds

time_spent (timediff)
Indicates the total time spent in the worklog in terms of hours, minutes and seconds

$ curl <url>//api/v3/releases/{release_id}/tasks/{task_id}/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": "100000000000033531"
        },
        "description": "",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "50",
            "minutes": "30"
        },
        "tech_charge": "250",
        "other_charge": "0",
        "worklog_type": null,
        "include_nonoperational_hours": true,
        "mark_first_response": false
    }
}'

// Deluge Sample script
url = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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": "100000000000033531"
        },
        "description": "",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "50",
            "minutes": "30"
        },
        "tech_charge": "250",
        "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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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": "100000000000033531"
        },
        "description": "",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "50",
            "minutes": "30"
        },
        "tech_charge": "250",
        "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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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": "100000000000033531"
        },
        "description": "",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "50",
            "minutes": "30"
        },
        "tech_charge": "250",
        "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": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "cost_per_hour": "0.0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "include_nonoperational_hours": true,
        "end_time": {
            "display_value": "Jan 27, 2022 05:52 PM",
            "value": "1643286121982"
        },
        "description": "",
        "other_charge": "0",
        "total_charge": "250",
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Jan 27, 2022 05:22 PM",
            "value": "1643284338940"
        },
        "time_spent": {
            "hours": "50",
            "minutes": "30",
            "value": "181800000"
        },
        "tech_charge": "250",
        "start_time": {
            "display_value": "Jan 25, 2022 03:22 PM",
            "value": "1643104321982"
        },
        "worklog_type": null,
        "id": "100000000000040313"
    }
}

Edit Release Task Worklog

This operation helps to update a worklog for a release task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}

Attributes

id (long)
Indicates the unique ID of the Worklog

id (long)
Numerical digits which are considered to have larger values.

Example 

234759602834500

owner (user)
Indicates the owner for the worklog

owner (user)
Indicates the owner for the worklog

Example 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_owner",
    "id": "100000000000042013"
  }
}

description (html)
Contains the description about the worklog

description (html)
HTML is a text area where html elements can be used.

Example 

<b>The content to be displayed</b>

start_time (datetime)
Contains 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

start_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

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

end_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

recorded_time (datetime)
Contains the date and time of creation of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format

recorded_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

other_charge (double)

Indicates the extra charges other than the technician charges

other_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

tech_charge (double)

Indicates the technician charges related to the worklog

tech_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

include_nonoperational_hours (boolean)

Indicates whether to include non-operational hours or not

include_nonoperational_hours (boolean)
Boolean value which can have two possible values. The values are true and false.

mark_first_response (boolean)

Indicates whether to mark response date of a Request/ticket while adding worklog for that request/ticket

mark_first_response (boolean)
Boolean value which can have two possible values. The values are true and false.

worklog_type (worklog_type)

Indicates the different modes of technician’s work

worklog_type (worklog_type)
Indicates the different modes of technician’s work

Example 

{
  "worklog_type": {
    "name": "test_worklog_type",
    "id": "133333300000042011"
  }
}

created_by (user)read only

Indicates the user who created the worklog

created_by (user)
Indicates the user who created the worklog

Example 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

total_charge (double)read only

Indicates the total charges related to the worklog

total_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

time_spent (timediff)

Indicates the total time spent in the worklog in terms of hours, minutes and seconds

time_spent (timediff)
Indicates the total time spent in the worklog in terms of hours, minutes and seconds

$ curl <url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}\
      -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": "100000000000033531"
        },
        "description": "Trial ",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30"
        },
        "tech_charge": "0.00",
        "other_charge": "15",
        "worklog_type": null,
        "include_nonoperational_hours": false,
        "mark_first_response": false
    }
}'

// Deluge Sample script
url = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}";
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": "100000000000033531"
        },
        "description": "Trial ",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30"
        },
        "tech_charge": "0.00",
        "other_charge": "15",
        "worklog_type": null,
        "include_nonoperational_hours": false,
        "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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
$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": "100000000000033531"
        },
        "description": "Trial ",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30"
        },
        "tech_charge": "0.00",
        "other_charge": "15",
        "worklog_type": null,
        "include_nonoperational_hours": false,
        "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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
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": "100000000000033531"
        },
        "description": "Trial ",
        "start_time": {
            "value": "1643104321982"
        },
        "end_time": {
            "value": "1643286121982"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30"
        },
        "tech_charge": "0.00",
        "other_charge": "15",
        "worklog_type": null,
        "include_nonoperational_hours": false,
        "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": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "cost_per_hour": "0.0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "include_nonoperational_hours": false,
        "end_time": {
            "display_value": "Jan 27, 2022 05:52 PM",
            "value": "1643286121982"
        },
        "description": "Trial",
        "other_charge": "15",
        "total_charge": "15",
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Jan 27, 2022 05:22 PM",
            "value": "1643284338940"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30",
            "value": "73800000"
        },
        "tech_charge": "0",
        "start_time": {
            "display_value": "Jan 25, 2022 03:22 PM",
            "value": "1643104321982"
        },
        "worklog_type": null,
        "id": "100000000000040313"
    }
}

Get Release Task Worklog

This operation helps to get a release worklog

Url

/api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}

Attributes

id (long)
Indicates the unique ID of the Worklog

id (long)
Numerical digits which are considered to have larger values.

Example 

234759602834500

owner (user)
Indicates the owner for the worklog

owner (user)
Indicates the owner for the worklog

Example 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_owner",
    "id": "100000000000042013"
  }
}

description (html)
Contains the description about the worklog

description (html)
HTML is a text area where html elements can be used.

Example 

<b>The content to be displayed</b>

start_time (datetime)
Contains 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

start_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

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

end_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

recorded_time (datetime)
Contains the date and time of creation of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format

recorded_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

other_charge (double)

Indicates the extra charges other than the technician charges

other_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

tech_charge (double)

Indicates the technician charges related to the worklog

tech_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

include_nonoperational_hours (boolean)

Indicates whether to include non-operational hours or not

include_nonoperational_hours (boolean)
Boolean value which can have two possible values. The values are true and false.

mark_first_response (boolean)

Indicates whether to mark response date of a Request/ticket while adding worklog for that request/ticket

mark_first_response (boolean)
Boolean value which can have two possible values. The values are true and false.

worklog_type (worklog_type)

Indicates the different modes of technician’s work

worklog_type (worklog_type)
Indicates the different modes of technician’s work

Example 

{
  "worklog_type": {
    "name": "test_worklog_type",
    "id": "133333300000042011"
  }
}

created_by (user)read only

Indicates the user who created the worklog

created_by (user)
Indicates the user who created the worklog

Example 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

total_charge (double)read only

Indicates the total charges related to the worklog

total_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

time_spent (timediff)

Indicates the total time spent in the worklog in terms of hours, minutes and seconds

time_spent (timediff)
Indicates the total time spent in the worklog in terms of hours, minutes and seconds

$ curl -G <url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}\
      -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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}";
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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
$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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
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": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "cost_per_hour": "0.0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "include_nonoperational_hours": false,
        "end_time": {
            "display_value": "Jan 27, 2022 05:52 PM",
            "value": "1643286121982"
        },
        "description": "Trial",
        "other_charge": "15",
        "total_charge": "15",
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "recorded_time": {
            "display_value": "Jan 27, 2022 05:22 PM",
            "value": "1643284338940"
        },
        "time_spent": {
            "hours": "20",
            "minutes": "30",
            "value": "73800000"
        },
        "tech_charge": "0",
        "start_time": {
            "display_value": "Jan 25, 2022 03:22 PM",
            "value": "1643104321982"
        },
        "worklog_type": null,
        "id": "100000000000040313"
    }
}

Get List Release Task Worklog

This operation helps to get all release worklogs

Url

/api/v3/releases/{release_id}/tasks/{task_id}/worklogs

Attributes

id (long)
Indicates the unique ID of the Worklog

id (long)
Numerical digits which are considered to have larger values.

Example 

234759602834500

owner (user)
Indicates the owner for the worklog

owner (user)
Indicates the owner for the worklog

Example 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_owner",
    "id": "100000000000042013"
  }
}

description (html)
Contains the description about the worklog

description (html)
HTML is a text area where html elements can be used.

Example 

<b>The content to be displayed</b>

start_time (datetime)
Contains 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

start_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

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

end_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

recorded_time (datetime)
Contains the date and time of creation of the Worklog as a JSON Object and has the “value” in milliseconds and “display_value” in the standard date format

recorded_time (datetime)
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 ).

display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.

More Attributes Expand all

other_charge (double)

Indicates the extra charges other than the technician charges

other_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

tech_charge (double)

Indicates the technician charges related to the worklog

tech_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

include_nonoperational_hours (boolean)

Indicates whether to include non-operational hours or not

include_nonoperational_hours (boolean)
Boolean value which can have two possible values. The values are true and false.

mark_first_response (boolean)

Indicates whether to mark response date of a Request/ticket while adding worklog for that request/ticket

mark_first_response (boolean)
Boolean value which can have two possible values. The values are true and false.

worklog_type (worklog_type)

Indicates the different modes of technician’s work

worklog_type (worklog_type)
Indicates the different modes of technician’s work

Example 

{
  "worklog_type": {
    "name": "test_worklog_type",
    "id": "133333300000042011"
  }
}

created_by (user)read only

Indicates the user who created the worklog

created_by (user)
Indicates the user who created the worklog

Example 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

total_charge (double)read only

Indicates the total charges related to the worklog

total_charge (double)
These are numbers that can include contains decimals.

Example 

23.08

time_spent (timediff)

Indicates the total time spent in the worklog in terms of hours, minutes and seconds

time_spent (timediff)
Indicates the total time spent in the worklog in terms of hours, minutes and seconds

$ curl -G <url>//api/v3/releases/{release_id}/tasks/{task_id}/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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/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": 3
    },
    "worklogs": [{
            "owner": {
                "email_id": "test@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Test",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Test",
                "job_title": null
            },
            "include_nonoperational_hours": false,
            "end_time": {
                "display_value": "Jan 27, 2022 05:52 PM",
                "value": "1643286121982"
            },
            "description": "Trial",
            "other_charge": "15",
            "total_charge": "15",
            "created_by": {
                "email_id": "test@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Test",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Test",
                "job_title": null
            },
            "recorded_time": {
                "display_value": "Jan 27, 2022 05:22 PM",
                "value": "1643284338940"
            },
            "time_spent": {
                "hours": "20",
                "minutes": "30",
                "value": "73800000"
            },
            "tech_charge": "0",
            "start_time": {
                "display_value": "Jan 25, 2022 03:22 PM",
                "value": "1643104321982"
            },
            "worklog_type": null,
            "id": "100000000000040313"
        },
        {
            "owner": {
                "email_id": "test@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Test",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Test",
                "job_title": null
            },
            "include_nonoperational_hours": true,
            "end_time": {
                "display_value": "Jan 27, 2022 05:27 PM",
                "value": "1643284646797"
            },
            "description": "",
            "other_charge": "0",
            "total_charge": "0",
            "created_by": {
                "email_id": "trial@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Trial",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Trial",
                "job_title": null
            },
            "recorded_time": {
                "display_value": "Jan 27, 2022 05:27 PM",
                "value": "1643284656949"
            },
            "time_spent": {
                "hours": "34",
                "minutes": "00",
                "value": "122400000"
            },
            "tech_charge": "0",
            "start_time": {
                "display_value": "Jan 26, 2022 07:27 AM",
                "value": "1643162246797"
            },
            "worklog_type": null,
            "id": "100000000000040341"
        },
        {
            "owner": {
                "email_id": "test@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Test",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Test",
                "job_title": null
            },
            "include_nonoperational_hours": true,
            "end_time": {
                "display_value": "Jan 27, 2022 05:47 PM",
                "value": "1643285859280"
            },
            "description": "Demo worklog",
            "other_charge": "100",
            "total_charge": "100",
            "created_by": {
                "email_id": "test@test.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Test",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Test",
                "job_title": null
            },
            "recorded_time": {
                "display_value": "Jan 27, 2022 05:27 PM",
                "value": "1643284675608"
            },
            "time_spent": {
                "hours": "05",
                "minutes": "20",
                "value": "19200000"
            },
            "tech_charge": "0",
            "start_time": {
                "display_value": "Jan 27, 2022 12:27 PM",
                "value": "1643266659280"
            },
            "worklog_type": null,
            "id": "100000000000040353"
        }
    ]
}

Delete Release Task Worklog

This operation helps you to delete a worklog for a release task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}


$ curl <url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}\
      -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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}";
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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
$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 = "<url>//api/v3/releases/{release_id}/tasks/{task_id}/worklogs/{worklog_id}"
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"
  }
}