ManageEngine ServiceDesk plus

the manageengine servicedesk plus connector streamlines it service management by automating interactions with the servicedesk plus platform manageengine servicedesk plus is a comprehensive it service management (itsm) solution that enables organizations to manage and resolve service requests efficiently the swimlane turbine connector for servicedesk plus allows users to automate a wide range of itsm tasks, including the creation, update, and deletion of service requests, tasks, approvals, notes, and worklogs by integrating with servicedesk plus, swimlane turbine users can streamline their itsm workflows, enhance incident response with detailed documentation, and improve overall efficiency by reducing manual processes the manageengine servicedesk plus connector allows the cloud api allows you to perform all the operations that you do with our web client prerequisites to effectively utilize the manageengine servicedesk plus connector for turbine, ensure you have the following prerequisites api key authentication with the following parameters url endpoint url for the servicedesk plus api api key unique identifier to authenticate api requests custom authentication with the following parameters url endpoint url for the servicedesk plus api client id identifier for the oauth client client secret secret key for the oauth client code authorization code obtained during oauth flow custom authentication the servicedesk plus connector requires a client id, a client secret and a temporary code the following steps are required to set up the asset the procedure is somewhat different than with other connectors go to the zoho api console https //api console zoho com/ https //api console zoho com/ add client with self client it will show client id and client secret create manageengine servicedesk plus asset host {your host} paste the client id and client secret values from 2 save the asset go back to the self client application created in https //api console zoho com https //api console zoho com click 'generate code' for the tasks currently available, the needed scope is sdpondemand requests all time duration 10 minutes scope description whatever you want copy the 'generated code' create 'generate refresh token' task go to the generate refresh token task inputs and so on api key authentication the manageengine servicedesk plus connector uses the api key authentication method to connect to the manageengine servicedesk plus api the following are required to set up the asset api key this key is unique and serves as a credential for api requests an administrator generates an api key from the servicedesk plus web interface url the url is the base url of the servicedesk plus api capabilities this connector provides the following capabilities requests get request get list request delete request add attachment add new request request note add request note edit request note get request note get list request note delete request note request approval add request approval get request approval get list request approval delete request approval request task add request task edit request task get request task get list request task delete request task add attachment to a request task request worklow add request worklog edit request worklog get request worklog get list request worklog delete request worklog request task worklog add request task worklog edit request task worklog get request task worklog get list request task worklog delete request task worklog configurations manageengine servicedesk plus api key authenticates using an api key configuration parameters parameter description type required url a url to the target host string required apikey api key string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional manageengine servicedesk asset authenticates using client id, client secret and code configuration parameters parameter description type required url server host address string required client id the client id string required client secret the client secret string required code the code string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions add attachment adds an attachment to a specified request in manageengine servicedesk plus using the request id endpoint url /api/v3/requests/{{request id}}/ uploads method post input argument name type required description request id number required unique identifier form data object required response data addtoattachment boolean optional parameter for add attachment files array optional parameter for add attachment file name string required name of the resource file string required parameter for add attachment output parameter type description status code number http status code of the response reason string response reason phrase files array output field files content type string type of the resource size string output field size file id string unique identifier name string name of the resource content url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "files" \[] } } ] add attachment to a request task adds an attachment to a specific task within a request in manageengine servicedesk plus using the provided request and task ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/ uploads method post input argument name type required description request id number required unique identifier task id number required unique identifier form data object required response data addtoattachment boolean optional parameter for add attachment to a request task files array optional parameter for add attachment to a request task file name string required name of the resource file string required parameter for add attachment to a request task output parameter type description status code number http status code of the response reason string response reason phrase files array output field files content type string type of the resource size string output field size file id string unique identifier name string name of the resource content url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "files" \[] } } ] add request adds a new service request to manageengine servicedesk plus using the 'subject' parameter provided by the user endpoint url /api/v3/requests method post input argument name type required description request id number optional unique identifier subject string required parameter for add request description string optional parameter for add request impact details string optional parameter for add request email ids to notify string optional unique identifier delete pre template tasks boolean optional parameter for add request output parameter type description status code number http status code of the response reason string response reason phrase request object output field request total cost string output field total cost subject string output field subject resolution object output field resolution add to linked requests boolean output field add to linked requests content string response content is read boolean output field is read mode object output field mode name string name of the resource id string unique identifier lifecycle object output field lifecycle inactive boolean output field inactive is published boolean output field is published name string name of the resource id string unique identifier assets array output field assets name string name of the resource id string unique identifier barcode string output field barcode configuration items array output field configuration items linked instance string output field linked instance name string name of the resource id string unique identifier example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "request" {} } } ] add request approval adds an approval for a specific request in manageengine servicedesk plus using the request id and approval level id endpoint url /api/v3/requests/{{request id}}/approval levels/{{approval level id}}/approvals method post input argument name type required description request id number required unique identifier approval level id number required unique identifier comments string optional comments given on the approval by the approver \[max length 250] approver object optional approver of the approval email id string optional unique identifier original approver object optional the back approver, to whom the approval has been sent when the approver is on leave/not available email id string optional unique identifier xpath object optional parameter for add request approval path string optional parameter for add request approval display name string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase approval object output field approval approver object output field approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user xpath object output field xpath path object output field path comments string output field comments original approver object output field original approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "approval" {} } } ] add request note adds a note to an existing request in manageengine servicedesk plus using the specified request id and note description endpoint url /api/v3/requests/{{request id}}/notes method post input argument name type required description request id number required unique identifier description string required indicates the description of the note show to requester boolean optional parameter for add request note notify technician boolean optional parameter for add request note mark first response boolean optional parameter for add request note add to linked requests boolean optional parameter for add request note output parameter type description status code number http status code of the response reason string response reason phrase request note object output field request note mark first response boolean output field mark first response created time object time value display value string value for the parameter value string value for the parameter add to linked requests boolean output field add to linked requests request object output field request display id string unique identifier subject string output field subject id string unique identifier notify technician boolean output field notify technician show to requester boolean output field show to requester description string output field description id string unique identifier created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "request note" {} } } ] add request task adds a new task to an existing request in manageengine servicedesk plus using the specified request id and task title endpoint url /api/v3/requests/{{request id}}/tasks method post input argument name type required description request id number required unique identifier title string required title of the task description string optional parameter for add request task scheduled start time object optional time value value string optional value for the parameter scheduled end time object optional time value value string optional value for the parameter actual start time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase task object output field task percentage completion string output field percentage completion request object output field request id string unique identifier estimated effort hours string output field estimated effort hours attachments array output field attachments file name string name of the resource file string output field file email before string output field email before description string output field description title string output field title marked technician object output field marked technician email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user department object output field department overdue boolean output field overdue example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "task" {} } } ] add request task worklog adds a worklog entry for a specific task within a request in manageengine servicedesk plus, requiring request id, task id, and owner endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/worklogs method post input argument name type required description request id number required unique identifier task id number required unique identifier owner string required owner of the worklog description string optional parameter for add request task worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] add request worklog adds a worklog entry to a specific request in manageengine servicedesk plus using the request id and owner details endpoint url /api/v3/requests/{{request id}}/worklogs method post input argument name type required description request id number required unique identifier owner string required owner for the worklog description string optional parameter for add request worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] delete request permanently removes a specified request from manageengine servicedesk plus using the request id endpoint url /api/v3/requests/{{request id}} method delete input argument name type required description request id number required unique identifier delete request approval deletes a specified request approval in manageengine servicedesk plus using the request id, approval level id, and approval id endpoint url /api/v3/requests/{{request id}}/approval levels/{{approval level id}}/approvals/{{approval id}} method delete input argument name type required description request id number required unique identifier approval level id number required unique identifier approval id number required unique identifier delete request note remove a specific note from a service request in manageengine servicedesk plus using the request id and note id endpoint url /api/v3/requests/{{request id}}/notes/{{request note id}} method delete input argument name type required description request id number required unique identifier request note id number required unique identifier delete request task deletes a specific task from a service request in manageengine servicedesk plus using the provided request and task ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}} method delete input argument name type required description request id number required unique identifier task id number required unique identifier delete request task worklog deletes a specified worklog for a task within a request in manageengine servicedesk plus using the provided request, task, and worklog ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/worklogs/{{worklog id}} method delete input argument name type required description request id number required unique identifier task id number required unique identifier worklog id number required unique identifier delete request worklog deletes a specific worklog entry from a service request in manageengine servicedesk plus using the provided request and worklog ids endpoint url /api/v3/requests/{{request id}}/worklogs/{{worklog id}} method delete input argument name type required description request id number required unique identifier worklog id number required unique identifier edit request note updates an existing note for a specific request in manageengine servicedesk plus using the request id and note id endpoint url /api/v3/requests/{{request id}}/notes/{{request note id}} method put input argument name type required description request id number required unique identifier request note id number required unique identifier mark first response boolean optional parameter for edit request note add to linked requests boolean optional parameter for edit request note notify technician boolean optional parameter for edit request note show to requester boolean optional parameter for edit request note description string optional parameter for edit request note output parameter type description status code number http status code of the response reason string response reason phrase request note object output field request note mark first response boolean output field mark first response created time object time value display value string value for the parameter value string value for the parameter add to linked requests boolean output field add to linked requests request object output field request display id string unique identifier subject string output field subject id string unique identifier notify technician boolean output field notify technician show to requester boolean output field show to requester description string output field description id string unique identifier created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "request note" {} } } ] edit request task update a specific task within a request in manageengine servicedesk plus using the provided request and task ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}} method put input argument name type required description request id number required unique identifier task id number required unique identifier title string optional parameter for edit request task description string optional parameter for edit request task scheduled start time object optional time value value string optional value for the parameter scheduled end time object optional time value value string optional value for the parameter actual start time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase task object output field task percentage completion string output field percentage completion request object output field request id string unique identifier estimated effort hours string output field estimated effort hours attachments array output field attachments file name string name of the resource file string output field file email before string output field email before description string output field description title string output field title marked technician object output field marked technician email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user department object output field department overdue boolean output field overdue example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "task" {} } } ] edit request task worklog updates the worklog for a specific task within a request in manageengine servicedesk plus using the provided request, task, and worklog ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/worklogs/{{worklog id}} method put input argument name type required description request id number required unique identifier task id number required unique identifier worklog id number required unique identifier owner string optional parameter for edit request task worklog description string optional parameter for edit request task worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] edit request worklog updates the worklog for a specific request in manageengine servicedesk plus using request and worklog ids endpoint url /api/v3/requests/{{request id}}/worklogs/{{worklog id}} method put input argument name type required description request id number required unique identifier worklog id number required unique identifier owner string optional parameter for edit request worklog description string optional parameter for edit request worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] get list request retrieve all service requests from manageengine servicedesk plus, providing a comprehensive overview of user submissions endpoint url /api/v3/requests method get input argument name type required description id number optional unique identifier subject string optional parameter for get list request update reason string optional response reason phrase created time string optional time value due by time string optional time value scheduled start time string optional time value output parameter type description status code number http status code of the response reason string response reason phrase list info object output field list info has more rows boolean output field has more rows start index number output field start index sort field string output field sort field page number output field page sort order string output field sort order row count number count value requests array output field requests total cost string output field total cost subject string output field subject cancellation requested boolean output field cancellation requested id string unique identifier group object output field group site string output field site deleted boolean output field deleted name string name of the resource id string unique identifier requester object output field requester email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "list info" {}, "requests" \[] } } ] get list request approval retrieve all approval details for a specific request and approval level in manageengine servicedesk plus, using the request id and approval level id endpoint url /api/v3/requests/{{request id}}/approval levels/{{approval level id}}/approvals method get input argument name type required description request id number required unique identifier approval level id number required unique identifier comments string optional parameter for get list request approval approver object optional parameter for get list request approval email id string optional unique identifier name string optional name of the resource id string optional unique identifier original approver object optional parameter for get list request approval name string optional name of the resource id string optional unique identifier xpath object optional parameter for get list request approval path string optional parameter for get list request approval display name string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase approvals array output field approvals approver object output field approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user xpath object output field xpath path object output field path comments string output field comments original approver object output field original approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "approvals" \[] } } ] get list request note retrieve all notes associated with a given request id in manageengine servicedesk plus endpoint url /api/v3/requests/{{request id}}/notes method get input argument name type required description request id number required unique identifier description string optional parameter for get list request note show to requester boolean optional parameter for get list request note notify technician boolean optional parameter for get list request note mark first response boolean optional parameter for get list request note add to linked requests boolean optional parameter for get list request note output parameter type description status code number http status code of the response reason string response reason phrase notes array output field notes mark first response boolean output field mark first response created time object time value display value string value for the parameter value string value for the parameter add to linked requests boolean output field add to linked requests request object output field request display id string unique identifier subject string output field subject id string unique identifier notify technician boolean output field notify technician show to requester boolean output field show to requester description string output field description id string unique identifier created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "notes" \[] } } ] get list request task retrieve all tasks associated with a specific request in manageengine servicedesk plus using the request id endpoint url /api/v3/requests/{{request id}}/tasks method get input argument name type required description request id number required unique identifier title string optional parameter for get list request task description string optional parameter for get list request task scheduled start time object optional time value value string optional value for the parameter scheduled end time object optional time value value string optional value for the parameter actual start time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase list info object output field list info has more rows boolean output field has more rows row count number count value tasks array output field tasks percentage completion string output field percentage completion request object output field request id string unique identifier estimated effort hours string output field estimated effort hours email before string output field email before description string output field description title string output field title marked technician object output field marked technician email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user department object output field department overdue boolean output field overdue example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "list info" {}, "tasks" \[] } } ] get list request task worklog retrieve all worklogs associated with a specific task and request in manageengine servicedesk plus, using the provided request id and task id endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/worklogs method get input argument name type required description request id number required unique identifier task id number required unique identifier owner string optional parameter for get list request task worklog description string optional parameter for get list request task worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase list info object output field list info has more rows boolean output field has more rows row count number count value worklogs array output field worklogs owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge id string unique identifier example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "list info" {}, "worklogs" \[] } } ] get list request worklog retrieve all worklog entries for a specific request in manageengine servicedesk plus using the request id endpoint url /api/v3/requests/{{request id}}/worklogs method get input argument name type required description request id number required unique identifier owner string optional parameter for get list request worklog description string optional parameter for get list request worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase list info object output field list info has more rows boolean output field has more rows row count number count value worklogs array output field worklogs owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "list info" {}, "worklogs" \[] } } ] get request retrieve detailed information for a specific request in manageengine servicedesk plus using the provided request id endpoint url /api/v3/requests/{{request id}} method get input argument name type required description request id number required unique identifier subject string optional parameter for get request description string optional parameter for get request impact details string optional parameter for get request email ids to notify string optional unique identifier delete pre template tasks boolean optional parameter for get request output parameter type description status code number http status code of the response reason string response reason phrase request object output field request total cost string output field total cost subject string output field subject resolution object output field resolution add to linked requests boolean output field add to linked requests content string response content is read boolean output field is read mode object output field mode name string name of the resource id string unique identifier lifecycle object output field lifecycle inactive boolean output field inactive is published boolean output field is published name string name of the resource id string unique identifier assets array output field assets name string name of the resource id string unique identifier barcode string output field barcode example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "request" {} } } ] get request approval retrieve approval details for a specific request in manageengine servicedesk plus using request id, approval level id, and approval id endpoint url /api/v3/requests/{{request id}}/approval levels/{{approval level id}}/approvals/{{approval id}} method get input argument name type required description request id number required unique identifier approval level id number required unique identifier approval id number required unique identifier comments string optional parameter for get request approval approver object optional parameter for get request approval email id string optional unique identifier name string optional name of the resource id string optional unique identifier original approver object optional parameter for get request approval name string optional name of the resource id string optional unique identifier xpath object optional parameter for get request approval path string optional parameter for get request approval display name string optional name of the resource output parameter type description status code number http status code of the response reason string response reason phrase approval object output field approval approver object output field approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user xpath object output field xpath path object output field path comments string output field comments original approver object output field original approver email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "approval" {} } } ] get request note retrieves a specific note from a service request in manageengine servicedesk plus using the request id and note id endpoint url /api/v3/requests/{{request id}}/notes/{{request note id}} method get input argument name type required description request id number required unique identifier request note id number required unique identifier mark first response boolean optional parameter for get request note add to linked requests boolean optional parameter for get request note notify technician boolean optional parameter for get request note show to requester boolean optional parameter for get request note description string optional parameter for get request note output parameter type description status code number http status code of the response reason string response reason phrase request note object output field request note mark first response boolean output field mark first response created time object time value display value string value for the parameter value string value for the parameter add to linked requests boolean output field add to linked requests request object output field request display id string unique identifier subject string output field subject id string unique identifier notify technician boolean output field notify technician show to requester boolean output field show to requester description string output field description id string unique identifier created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "request note" {} } } ] get request task retrieves detailed information for a specific task associated with a given request in manageengine servicedesk plus using the request and task ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}} method get input argument name type required description request id number required unique identifier task id number required unique identifier title string optional parameter for get request task description string optional parameter for get request task scheduled start time object optional time value value string optional value for the parameter scheduled end time object optional time value value string optional value for the parameter actual start time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase task object output field task percentage completion string output field percentage completion request object output field request id string unique identifier estimated effort hours string output field estimated effort hours attachments array output field attachments file name string name of the resource file string output field file email before string output field email before description string output field description title string output field title marked technician object output field marked technician email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user department object output field department id string unique identifier example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "task" {} } } ] get request task worklog retrieve worklog details for a specific task within a request in manageengine servicedesk plus, using the request, task, and worklog ids endpoint url /api/v3/requests/{{request id}}/tasks/{{task id}}/worklogs/{{worklog id}} method get input argument name type required description request id number required unique identifier task id number required unique identifier worklog id number required unique identifier owner string optional parameter for get request task worklog description string optional parameter for get request task worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] get request worklog retrieves the worklog details for a specific request using the request id and worklog id in manageengine servicedesk plus endpoint url /api/v3/requests/{{request id}}/worklogs/{{worklog id}} method get input argument name type required description request id number required unique identifier worklog id number required unique identifier owner string optional parameter for get request worklog description string optional parameter for get request worklog start time object optional time value value string optional value for the parameter end time object optional time value value string optional value for the parameter recorded time object optional time value value string optional value for the parameter output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog owner object output field owner email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone name string name of the resource mobile string output field mobile id string unique identifier photo url string url endpoint for the request is vip user boolean output field is vip user include nonoperational hours boolean output field include nonoperational hours end time object time value display value string value for the parameter value string value for the parameter description string output field description other charge number output field other charge total charge number output field total charge created by object output field created by email id string unique identifier is technician boolean output field is technician sms mail string output field sms mail phone string output field phone example \[ { "status code" 200, "reason" "ok", "response headers" {}, "json body" { "worklog" {} } } ] notes for more information on manageengine servicedesk plus is found at servicedesk rest api https //www manageengine com/products/service desk/sdpod v3 api/sdpod v3 api html#introduction