ManageEngine ServiceDesk plus
125 min
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/ 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 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 notes for more information on manageengine servicedesk plus is found at https //www manageengine com/products/service desk/sdpod v3 api/sdpod v3 api html#introduction 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 path parameters request id number required parameters for the add attachment action form data object required response data form data addtoattachment boolean optional response data form data files array optional response data form data files file name string required response data form data files file string required response data input example {"path parameters" {"request id" 2443600536133958},"form data" {"addtoattachment"\ false,"files" \[{"file" " /data/files/s png","file name" "s png"}]}} output parameter type description status code number http status code of the response reason string response reason phrase files array output field files files content type string type of the resource files size string output field files size files file id string unique identifier files name string name of the resource files content url string url endpoint for the request output 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 path parameters request id number required parameters for the add attachment to a request task action path parameters task id number required parameters for the add attachment to a request task action form data object required response data form data addtoattachment boolean optional response data form data files array optional response data form data files file name string required response data form data files file string required response data input example {"path parameters" {"request id" 2443600536133958},"form data" {"addtoattachment"\ false,"files" \[{"file" " /data/files/s png","file name" "s png"}]}} output parameter type description status code number http status code of the response reason string response reason phrase files array output field files files content type string type of the resource files size string output field files size files file id string unique identifier files name string name of the resource files content url string url endpoint for the request output 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 parameters request id number optional parameters for the add request action parameters subject string required parameters for the add request action parameters description string optional parameters for the add request action parameters impact details string optional parameters for the add request action parameters email ids to notify string optional parameters for the add request action parameters delete pre template tasks boolean optional parameters for the add request action input example {"parameters" {"request id" 2443600536133958,"subject" "need an external monitor","description" "description","impact details" "details of the impact","email ids to notify" "lincoln\@zmail com","delete pre template tasks"\ false}} output parameter type description status code number http status code of the response reason string response reason phrase request object output field request request total cost string output field request total cost request subject string output field request subject request resolution object output field request resolution request resolution add to linked requests boolean output field request resolution add to linked requests request resolution content string response content request is read boolean output field request is read request mode object output field request mode request mode name string name of the resource request mode id string unique identifier request lifecycle object output field request lifecycle request lifecycle inactive boolean output field request lifecycle inactive request lifecycle is published boolean output field request lifecycle is published request lifecycle name string name of the resource request lifecycle id string unique identifier request assets array output field request assets request assets name string name of the resource request assets id string unique identifier request assets barcode string output field request assets barcode request configuration items array output field request configuration items request configuration items linked instance string output field request configuration items linked instance request configuration items name string name of the resource request configuration items id string unique identifier output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"request" {"total cost" "250","subject" "need an external monitor","resolution" {},"is read"\ false,"mode" {},"lifecycle" {},"assets" \[],"configuration items" \[],"project id" "test project id","cancellation requested"\ false,"is trashed"\ false,"has change initiated request" "true","id" "2290537481381500","assigned time" {}}}} 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 path parameters request id number required parameters for the add request approval action path parameters approval level id number required parameters for the add request approval action parameters comments string optional comments given on the approval by the approver \[max length 250] parameters approver object optional approver of the approval parameters approver email id string optional parameters for the add request approval action parameters original approver object optional the back approver, to whom the approval has been sent when the approver is on leave/not available parameters original approver email id string optional parameters for the add request approval action parameters xpath object optional parameters for the add request approval action parameters xpath path string optional parameters for the add request approval action parameters xpath display name string optional parameters for the add request approval action input example {"parameters" {"comments" "comments for why this entity is approved/rejected","approver" {"email id" "lincoln\@zmail com"},"original approver" {"email id" "lincoln\@zmail com"},"xpath" {"path" "orgroles udf ref6","display name" "general manager"}},"path parameters" {"request id" 2443600536133958,"approval level id" 234567890123456}} output parameter type description status code number http status code of the response reason string response reason phrase approval object output field approval approval approver object output field approval approver approval approver email id string unique identifier approval approver is technician boolean output field approval approver is technician approval approver sms mail string output field approval approver sms mail approval approver phone string output field approval approver phone approval approver name string name of the resource approval approver mobile string output field approval approver mobile approval approver id string unique identifier approval approver photo url string url endpoint for the request approval approver is vip user boolean output field approval approver is vip user approval xpath object output field approval xpath approval xpath path object output field approval xpath path approval comments string output field approval comments approval original approver object output field approval original approver approval original approver email id string unique identifier approval original approver is technician boolean output field approval original approver is technician approval original approver sms mail string output field approval original approver sms mail approval original approver phone string output field approval original approver phone approval original approver name string name of the resource approval original approver mobile string output field approval original approver mobile approval original approver id string unique identifier approval original approver photo url string url endpoint for the request output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"approval" {"approver" {},"xpath" {},"comments" "comments for why this entity is approved/rejected","original approver" {},"approval level" {}}}} 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 path parameters request id number required parameters for the add request note action parameters description string required indicates the description of the note parameters show to requester boolean optional parameters for the add request note action parameters notify technician boolean optional parameters for the add request note action parameters mark first response boolean optional parameters for the add request note action parameters add to linked requests boolean optional parameters for the add request note action input example {"parameters" {"description" "the following is the note for the associated request","show to requester"\ false,"notify technician"\ false,"mark first response"\ false,"add to linked requests"\ false},"path parameters" {"request id" 2443600536133958}} 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 request note mark first response boolean output field request note mark first response request note created time object time value request note created time display value string value for the parameter request note created time value string value for the parameter request note add to linked requests boolean output field request note add to linked requests request note request object output field request note request request note request display id string unique identifier request note request subject string output field request note request subject request note request id string unique identifier request note notify technician boolean output field request note notify technician request note show to requester boolean output field request note show to requester request note description string output field request note description request note id string unique identifier request note created by object output field request note created by request note created by email id string unique identifier request note created by is technician boolean output field request note created by is technician request note created by sms mail string output field request note created by sms mail request note created by phone string output field request note created by phone request note created by name string name of the resource request note created by mobile string output field request note created by mobile request note created by id string unique identifier request note created by photo url string url endpoint for the request output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"request note" {"mark first response"\ false,"created time" {},"add to linked requests"\ false,"request" {},"notify technician"\ false,"show to requester"\ false,"description" "the following is the note for the associated request","id" "1997129173325228","created by" {}}}} 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 path parameters request id number required parameters for the add request task action parameters title string required title of the task parameters description string optional parameters for the add request task action parameters scheduled start time object optional parameters for the add request task action parameters scheduled start time value string optional parameters for the add request task action parameters scheduled end time object optional parameters for the add request task action parameters scheduled end time value string optional parameters for the add request task action parameters actual start time object optional parameters for the add request task action parameters actual start time value string optional parameters for the add request task action input example {"parameters" {"title" "create srs","description" "the srs must contain all the requirements for the feature","scheduled start time" {"value" "1421988300000"},"scheduled end time" {"value" "1512974940000"},"actual start time" {"value" "1421988300000"}},"path parameters" {"request id" 2443600536133958}} output parameter type description status code number http status code of the response reason string response reason phrase task object output field task task percentage completion string output field task percentage completion task request object output field task request task request id string unique identifier task estimated effort hours string output field task estimated effort hours task attachments array output field task attachments task attachments file name string name of the resource task attachments file string output field task attachments file task email before string output field task email before task description string output field task description task title string output field task title task marked technician object output field task marked technician task marked technician email id string unique identifier task marked technician is technician boolean output field task marked technician is technician task marked technician sms mail string output field task marked technician sms mail task marked technician phone string output field task marked technician phone task marked technician name string name of the resource task marked technician mobile string output field task marked technician mobile task marked technician id string unique identifier task marked technician photo url string url endpoint for the request task marked technician is vip user boolean output field task marked technician is vip user task marked technician department object output field task marked technician department task overdue boolean output field task overdue output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"task" {"percentage completion" "30","request" {},"estimated effort hours" "20","attachments" \[],"email before" "3600000","description" "the srs must contain all the requirements for the feature","title" "create srs","marked technician" {},"overdue"\ false,"additional cost" "100","actual end time" {},"id" "1504379411346066","actual start time" {},"owner" {},"associated entity" "request"}}} 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 path parameters request id number required parameters for the add request task worklog action path parameters task id number required parameters for the add request task worklog action parameters owner string required owner of the worklog parameters description string optional parameters for the add request task worklog action parameters start time object optional parameters for the add request task worklog action parameters start time value string optional parameters for the add request task worklog action parameters end time object optional parameters for the add request task worklog action parameters end time value string optional parameters for the add request task worklog action parameters recorded time object optional parameters for the add request task worklog action parameters recorded time value string optional parameters for the add request task worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "2469549357974301"}}} 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 path parameters request id number required parameters for the add request worklog action parameters owner string required owner for the worklog parameters description string optional parameters for the add request worklog action parameters start time object optional parameters for the add request worklog action parameters start time value string optional parameters for the add request worklog action parameters end time object optional parameters for the add request worklog action parameters end time value string optional parameters for the add request worklog action parameters recorded time object optional parameters for the add request worklog action parameters recorded time value string optional parameters for the add request worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "2469549357974301"}}} 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 path parameters request id number required parameters for the delete request action input example {"path parameters" {"request id" 2079997951635005}} 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 path parameters request id number required parameters for the delete request approval action path parameters approval level id number required parameters for the delete request approval action path parameters approval id number required parameters for the delete request approval action input example {"path parameters" {"request id" 573363737610000,"approval level id" 234567890123456,"approval id" 1807795817979319}} 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 path parameters request id number required parameters for the delete request note action path parameters request note id number required parameters for the delete request note action input example {"path parameters" {"request id" 2443600536133958,"request note id" 2156096055331149}} 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 path parameters request id number required parameters for the delete request task action path parameters task id number required parameters for the delete request task action input example {"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512}} 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 path parameters request id number required parameters for the delete request task worklog action path parameters task id number required parameters for the delete request task worklog action path parameters worklog id number required parameters for the delete request task worklog action input example {"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512,"worklog id" 1778953679609145}} 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 path parameters request id number required parameters for the delete request worklog action path parameters worklog id number required parameters for the delete request worklog action input example {"path parameters" {"request id" 2443600536133958,"worklog id" 1778953679609145}} 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 path parameters request id number required parameters for the edit request note action path parameters request note id number required parameters for the edit request note action parameters mark first response boolean optional parameters for the edit request note action parameters add to linked requests boolean optional parameters for the edit request note action parameters notify technician boolean optional parameters for the edit request note action parameters show to requester boolean optional parameters for the edit request note action parameters description string optional parameters for the edit request note action input example {"parameters" {"mark first response"\ false,"add to linked requests"\ false,"notify technician"\ false,"show to requester"\ false,"description" "the following is the note for the associated request"},"path parameters" {"request id" 2443600536133958,"request note id" 2156096055331149}} 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 request note mark first response boolean output field request note mark first response request note created time object time value request note created time display value string value for the parameter request note created time value string value for the parameter request note add to linked requests boolean output field request note add to linked requests request note request object output field request note request request note request display id string unique identifier request note request subject string output field request note request subject request note request id string unique identifier request note notify technician boolean output field request note notify technician request note show to requester boolean output field request note show to requester request note description string output field request note description request note id string unique identifier request note created by object output field request note created by request note created by email id string unique identifier request note created by is technician boolean output field request note created by is technician request note created by sms mail string output field request note created by sms mail request note created by phone string output field request note created by phone request note created by name string name of the resource request note created by mobile string output field request note created by mobile request note created by id string unique identifier request note created by photo url string url endpoint for the request output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"request note" {"mark first response"\ false,"created time" {},"add to linked requests"\ false,"request" {},"notify technician"\ false,"show to requester"\ false,"description" "the following is the note for the associated request","id" "2156096055331149","created by" {}}}} 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 path parameters request id number required parameters for the edit request task action path parameters task id number required parameters for the edit request task action parameters title string optional parameters for the edit request task action parameters description string optional parameters for the edit request task action parameters scheduled start time object optional parameters for the edit request task action parameters scheduled start time value string optional parameters for the edit request task action parameters scheduled end time object optional parameters for the edit request task action parameters scheduled end time value string optional parameters for the edit request task action parameters actual start time object optional parameters for the edit request task action parameters actual start time value string optional parameters for the edit request task action input example {"parameters" {"title" "create srs","description" "the srs must contain all the requirements for the feature","scheduled start time" {"value" "1421988300000"},"scheduled end time" {"value" "1512974940000"},"actual start time" {"value" "1421988300000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512}} output parameter type description status code number http status code of the response reason string response reason phrase task object output field task task percentage completion string output field task percentage completion task request object output field task request task request id string unique identifier task estimated effort hours string output field task estimated effort hours task attachments array output field task attachments task attachments file name string name of the resource task attachments file string output field task attachments file task email before string output field task email before task description string output field task description task title string output field task title task marked technician object output field task marked technician task marked technician email id string unique identifier task marked technician is technician boolean output field task marked technician is technician task marked technician sms mail string output field task marked technician sms mail task marked technician phone string output field task marked technician phone task marked technician name string name of the resource task marked technician mobile string output field task marked technician mobile task marked technician id string unique identifier task marked technician photo url string url endpoint for the request task marked technician is vip user boolean output field task marked technician is vip user task marked technician department object output field task marked technician department task overdue boolean output field task overdue output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"task" {"percentage completion" "30","request" {},"estimated effort hours" "20","attachments" \[],"email before" "3600000","description" "the srs must contain all the requirements for the feature","title" "create srs","marked technician" {},"overdue"\ false,"additional cost" "100","actual end time" {},"id" "1850904131920933","actual start time" {},"owner" {},"associated entity" "request"}}} 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 path parameters request id number required parameters for the edit request task worklog action path parameters task id number required parameters for the edit request task worklog action path parameters worklog id number required parameters for the edit request task worklog action parameters owner string optional parameters for the edit request task worklog action parameters description string optional parameters for the edit request task worklog action parameters start time object optional parameters for the edit request task worklog action parameters start time value string optional parameters for the edit request task worklog action parameters end time object optional parameters for the edit request task worklog action parameters end time value string optional parameters for the edit request task worklog action parameters recorded time object optional parameters for the edit request task worklog action parameters recorded time value string optional parameters for the edit request task worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512,"worklog id" 1509662054134177}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "1778953679609145"}}} 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 path parameters request id number required parameters for the edit request worklog action path parameters worklog id number required parameters for the edit request worklog action parameters owner string optional parameters for the edit request worklog action parameters description string optional parameters for the edit request worklog action parameters start time object optional parameters for the edit request worklog action parameters start time value string optional parameters for the edit request worklog action parameters end time object optional parameters for the edit request worklog action parameters end time value string optional parameters for the edit request worklog action parameters recorded time object optional parameters for the edit request worklog action parameters recorded time value string optional parameters for the edit request worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"worklog id" 1778953679609145}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "1778953679609145"}}} 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 parameters id number optional parameters for the get list request action parameters subject string optional parameters for the get list request action parameters update reason string optional parameters for the get list request action parameters created time string optional parameters for the get list request action parameters due by time string optional parameters for the get list request action parameters scheduled start time string optional parameters for the get list request action input example {"parameters" {"id" 2079997951635005,"subject" "need an external monitor","update reason" "the request is updated for this reason","created time" "nov 10, 2016 11 44 am","due by time" "nov 10, 2016 11 44 am","scheduled start time" "nov 10, 2016 11 44 am"}} 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 list info has more rows boolean output field list info has more rows list info start index number output field list info start index list info sort field string output field list info sort field list info page number output field list info page list info sort order string output field list info sort order list info row count number count value requests array output field requests requests total cost string output field requests total cost requests subject string output field requests subject requests cancellation requested boolean output field requests cancellation requested requests id string unique identifier requests group object output field requests group requests group site string output field requests group site requests group deleted boolean output field requests group deleted requests group name string name of the resource requests group id string unique identifier requests requester object output field requests requester requests requester email id string unique identifier requests requester is technician boolean output field requests requester is technician requests requester sms mail string output field requests requester sms mail requests requester phone string output field requests requester phone requests requester name string name of the resource output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"list info" {"has more rows"\ false,"start index" 1,"sort field" "created time","page" 1,"sort order" "desc","row count" 3},"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 path parameters request id number required parameters for the get list request approval action path parameters approval level id number required parameters for the get list request approval action parameters comments string optional parameters for the get list request approval action parameters approver object optional parameters for the get list request approval action parameters approver email id string optional parameters for the get list request approval action parameters approver name string optional parameters for the get list request approval action parameters approver id string optional parameters for the get list request approval action parameters original approver object optional parameters for the get list request approval action parameters original approver name string optional parameters for the get list request approval action parameters original approver id string optional parameters for the get list request approval action parameters xpath object optional parameters for the get list request approval action parameters xpath path string optional parameters for the get list request approval action parameters xpath display name string optional parameters for the get list request approval action input example {"parameters" {"comments" "comments for why this entity is approved/rejected","approver" {"email id" "andrews\@zmail com","name" "test approver","id" "234567890123456"},"original approver" {"name" "test original approver","id" "234567890123456"},"xpath" {"path" "org roles org ref1","display name" "general manager"}},"path parameters" {"request id" 573363737610000,"approval level id" 234567890123456}} output parameter type description status code number http status code of the response reason string response reason phrase approvals array output field approvals approvals approver object output field approvals approver approvals approver email id string unique identifier approvals approver is technician boolean output field approvals approver is technician approvals approver sms mail string output field approvals approver sms mail approvals approver phone string output field approvals approver phone approvals approver name string name of the resource approvals approver mobile string output field approvals approver mobile approvals approver id string unique identifier approvals approver photo url string url endpoint for the request approvals approver is vip user boolean output field approvals approver is vip user approvals xpath object output field approvals xpath approvals xpath path object output field approvals xpath path approvals comments string output field approvals comments approvals original approver object output field approvals original approver approvals original approver email id string unique identifier approvals original approver is technician boolean output field approvals original approver is technician approvals original approver sms mail string output field approvals original approver sms mail approvals original approver phone string output field approvals original approver phone approvals original approver name string name of the resource approvals original approver mobile string output field approvals original approver mobile approvals original approver id string unique identifier approvals original approver photo url string url endpoint for the request output 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 path parameters request id number required parameters for the get list request note action parameters description string optional parameters for the get list request note action parameters show to requester boolean optional parameters for the get list request note action parameters notify technician boolean optional parameters for the get list request note action parameters mark first response boolean optional parameters for the get list request note action parameters add to linked requests boolean optional parameters for the get list request note action input example {"parameters" {"description" "the following is the note for the associated request","show to requester"\ false,"notify technician"\ false,"mark first response"\ false,"add to linked requests"\ false},"path parameters" {"request id" 2443600536133958}} output parameter type description status code number http status code of the response reason string response reason phrase notes array output field notes notes mark first response boolean output field notes mark first response notes created time object time value notes created time display value string value for the parameter notes created time value string value for the parameter notes add to linked requests boolean output field notes add to linked requests notes request object output field notes request notes request display id string unique identifier notes request subject string output field notes request subject notes request id string unique identifier notes notify technician boolean output field notes notify technician notes show to requester boolean output field notes show to requester notes description string output field notes description notes id string unique identifier notes created by object output field notes created by notes created by email id string unique identifier notes created by is technician boolean output field notes created by is technician notes created by sms mail string output field notes created by sms mail notes created by phone string output field notes created by phone notes created by name string name of the resource notes created by mobile string output field notes created by mobile notes created by id string unique identifier notes created by photo url string url endpoint for the request output 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 path parameters request id number required parameters for the get list request task action parameters title string optional parameters for the get list request task action parameters description string optional parameters for the get list request task action parameters scheduled start time object optional parameters for the get list request task action parameters scheduled start time value string optional parameters for the get list request task action parameters scheduled end time object optional parameters for the get list request task action parameters scheduled end time value string optional parameters for the get list request task action parameters actual start time object optional parameters for the get list request task action parameters actual start time value string optional parameters for the get list request task action input example {"parameters" {"title" "create srs","description" "the srs must contain all the requirements for the feature","scheduled start time" {"value" "1421988300000"},"scheduled end time" {"value" "1512974940000"},"actual start time" {"value" "1421988300000"}},"path parameters" {"request id" 2443600536133958}} 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 list info has more rows boolean output field list info has more rows list info row count number count value tasks array output field tasks tasks percentage completion string output field tasks percentage completion tasks request object output field tasks request tasks request id string unique identifier tasks estimated effort hours string output field tasks estimated effort hours tasks email before string output field tasks email before tasks description string output field tasks description tasks title string output field tasks title tasks marked technician object output field tasks marked technician tasks marked technician email id string unique identifier tasks marked technician is technician boolean output field tasks marked technician is technician tasks marked technician sms mail string output field tasks marked technician sms mail tasks marked technician phone string output field tasks marked technician phone tasks marked technician name string name of the resource tasks marked technician mobile string output field tasks marked technician mobile tasks marked technician id string unique identifier tasks marked technician photo url string url endpoint for the request tasks marked technician is vip user boolean output field tasks marked technician is vip user tasks marked technician department object output field tasks marked technician department tasks overdue boolean output field tasks overdue output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"list info" {"has more rows"\ false,"row count" 1},"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 path parameters request id number required parameters for the get list request task worklog action path parameters task id number required parameters for the get list request task worklog action parameters owner string optional parameters for the get list request task worklog action parameters description string optional parameters for the get list request task worklog action parameters start time object optional parameters for the get list request task worklog action parameters start time value string optional parameters for the get list request task worklog action parameters end time object optional parameters for the get list request task worklog action parameters end time value string optional parameters for the get list request task worklog action parameters recorded time object optional parameters for the get list request task worklog action parameters recorded time value string optional parameters for the get list request task worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512}} 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 list info has more rows boolean output field list info has more rows list info row count number count value worklogs array output field worklogs worklogs owner object output field worklogs owner worklogs owner email id string unique identifier worklogs owner is technician boolean output field worklogs owner is technician worklogs owner sms mail string output field worklogs owner sms mail worklogs owner phone string output field worklogs owner phone worklogs owner name string name of the resource worklogs owner mobile string output field worklogs owner mobile worklogs owner id string unique identifier worklogs owner photo url string url endpoint for the request worklogs owner is vip user boolean output field worklogs owner is vip user worklogs include nonoperational hours boolean output field worklogs include nonoperational hours worklogs end time object time value worklogs end time display value string value for the parameter worklogs end time value string value for the parameter worklogs description string output field worklogs description worklogs other charge number output field worklogs other charge worklogs total charge number output field worklogs total charge worklogs id string unique identifier output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"list info" {"has more rows"\ false,"row count" 1},"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 path parameters request id number required parameters for the get list request worklog action parameters owner string optional parameters for the get list request worklog action parameters description string optional parameters for the get list request worklog action parameters start time object optional parameters for the get list request worklog action parameters start time value string optional parameters for the get list request worklog action parameters end time object optional parameters for the get list request worklog action parameters end time value string optional parameters for the get list request worklog action parameters recorded time object optional parameters for the get list request worklog action parameters recorded time value string optional parameters for the get list request worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958}} 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 list info has more rows boolean output field list info has more rows list info row count number count value worklogs array output field worklogs worklogs owner object output field worklogs owner worklogs owner email id string unique identifier worklogs owner is technician boolean output field worklogs owner is technician worklogs owner sms mail string output field worklogs owner sms mail worklogs owner phone string output field worklogs owner phone worklogs owner name string name of the resource worklogs owner mobile string output field worklogs owner mobile worklogs owner id string unique identifier worklogs owner photo url string url endpoint for the request worklogs owner is vip user boolean output field worklogs owner is vip user worklogs description string output field worklogs description worklogs other charge number output field worklogs other charge worklogs total charge number output field worklogs total charge worklogs created by object output field worklogs created by worklogs created by email id string unique identifier worklogs created by is technician boolean output field worklogs created by is technician worklogs created by sms mail string output field worklogs created by sms mail worklogs created by phone string output field worklogs created by phone worklogs created by name string name of the resource output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"list info" {"has more rows"\ false,"row count" 1},"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 path parameters request id number required parameters for the get request action parameters subject string optional parameters for the get request action parameters description string optional parameters for the get request action parameters impact details string optional parameters for the get request action parameters email ids to notify string optional parameters for the get request action parameters delete pre template tasks boolean optional parameters for the get request action input example {"parameters" {"subject" "need an external monitor","description" "description","impact details" "details of the impact","email ids to notify" "lincoln\@zmail com","delete pre template tasks"\ false},"path parameters" {"request id" 2443600536133958}} output parameter type description status code number http status code of the response reason string response reason phrase request object output field request request total cost string output field request total cost request subject string output field request subject request resolution object output field request resolution request resolution add to linked requests boolean output field request resolution add to linked requests request resolution content string response content request is read boolean output field request is read request mode object output field request mode request mode name string name of the resource request mode id string unique identifier request lifecycle object output field request lifecycle request lifecycle inactive boolean output field request lifecycle inactive request lifecycle is published boolean output field request lifecycle is published request lifecycle name string name of the resource request lifecycle id string unique identifier request assets array output field request assets request assets name string name of the resource request assets id string unique identifier request assets barcode string output field request assets barcode output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"request" {"total cost" "250","subject" "need an external monitor","resolution" {},"is read"\ false,"mode" {},"lifecycle" {},"assets" \[]}}} 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 path parameters request id number required parameters for the get request approval action path parameters approval level id number required parameters for the get request approval action path parameters approval id number required parameters for the get request approval action parameters comments string optional parameters for the get request approval action parameters approver object optional parameters for the get request approval action parameters approver email id string optional parameters for the get request approval action parameters approver name string optional parameters for the get request approval action parameters approver id string optional parameters for the get request approval action parameters original approver object optional parameters for the get request approval action parameters original approver name string optional parameters for the get request approval action parameters original approver id string optional parameters for the get request approval action parameters xpath object optional parameters for the get request approval action parameters xpath path string optional parameters for the get request approval action parameters xpath display name string optional parameters for the get request approval action input example {"parameters" {"comments" "comments for why this entity is approved/rejected","approver" {"email id" "andrews\@zmail com","name" "test approver","id" "234567890123456"},"original approver" {"name" "test original approver","id" "234567890123456"},"xpath" {"path" "org roles org ref1","display name" "general manager"}},"path parameters" {"request id" 573363737610000,"approval level id" 234567890123456,"approval id" 1807795817979319}} output parameter type description status code number http status code of the response reason string response reason phrase approval object output field approval approval approver object output field approval approver approval approver email id string unique identifier approval approver is technician boolean output field approval approver is technician approval approver sms mail string output field approval approver sms mail approval approver phone string output field approval approver phone approval approver name string name of the resource approval approver mobile string output field approval approver mobile approval approver id string unique identifier approval approver photo url string url endpoint for the request approval approver is vip user boolean output field approval approver is vip user approval xpath object output field approval xpath approval xpath path object output field approval xpath path approval comments string output field approval comments approval original approver object output field approval original approver approval original approver email id string unique identifier approval original approver is technician boolean output field approval original approver is technician approval original approver sms mail string output field approval original approver sms mail approval original approver phone string output field approval original approver phone approval original approver name string name of the resource approval original approver mobile string output field approval original approver mobile approval original approver id string unique identifier approval original approver photo url string url endpoint for the request output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"approval" {"approver" {},"xpath" {},"comments" "comments for why this entity is approved/rejected","original approver" {},"approval level" {},"id" "1668157746997366","sent on"\ null,"action taken on"\ null,"status" {}}}} 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 path parameters request id number required parameters for the get request note action path parameters request note id number required parameters for the get request note action parameters mark first response boolean optional parameters for the get request note action parameters add to linked requests boolean optional parameters for the get request note action parameters notify technician boolean optional parameters for the get request note action parameters show to requester boolean optional parameters for the get request note action parameters description string optional parameters for the get request note action input example {"parameters" {"mark first response"\ false,"add to linked requests"\ false,"notify technician"\ false,"show to requester"\ false,"description" "the following is the note for the associated request"},"path parameters" {"request id" 2443600536133958,"request note id" 2156096055331149}} 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 request note mark first response boolean output field request note mark first response request note created time object time value request note created time display value string value for the parameter request note created time value string value for the parameter request note add to linked requests boolean output field request note add to linked requests request note request object output field request note request request note request display id string unique identifier request note request subject string output field request note request subject request note request id string unique identifier request note notify technician boolean output field request note notify technician request note show to requester boolean output field request note show to requester request note description string output field request note description request note id string unique identifier request note created by object output field request note created by request note created by email id string unique identifier request note created by is technician boolean output field request note created by is technician request note created by sms mail string output field request note created by sms mail request note created by phone string output field request note created by phone request note created by name string name of the resource request note created by mobile string output field request note created by mobile request note created by id string unique identifier request note created by photo url string url endpoint for the request output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"request note" {"mark first response"\ false,"created time" {},"add to linked requests"\ false,"request" {},"notify technician"\ false,"show to requester"\ false,"description" "the following is the note for the associated request","id" "2399537119347635","created by" {}}}} 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 path parameters request id number required parameters for the get request task action path parameters task id number required parameters for the get request task action parameters title string optional parameters for the get request task action parameters description string optional parameters for the get request task action parameters scheduled start time object optional parameters for the get request task action parameters scheduled start time value string optional parameters for the get request task action parameters scheduled end time object optional parameters for the get request task action parameters scheduled end time value string optional parameters for the get request task action parameters actual start time object optional parameters for the get request task action parameters actual start time value string optional parameters for the get request task action input example {"parameters" {"title" "create srs","description" "the srs must contain all the requirements for the feature","scheduled start time" {"value" "1421988300000"},"scheduled end time" {"value" "1512974940000"},"actual start time" {"value" "1421988300000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512}} output parameter type description status code number http status code of the response reason string response reason phrase task object output field task task percentage completion string output field task percentage completion task request object output field task request task request id string unique identifier task estimated effort hours string output field task estimated effort hours task attachments array output field task attachments task attachments file name string name of the resource task attachments file string output field task attachments file task email before string output field task email before task description string output field task description task title string output field task title task marked technician object output field task marked technician task marked technician email id string unique identifier task marked technician is technician boolean output field task marked technician is technician task marked technician sms mail string output field task marked technician sms mail task marked technician phone string output field task marked technician phone task marked technician name string name of the resource task marked technician mobile string output field task marked technician mobile task marked technician id string unique identifier task marked technician photo url string url endpoint for the request task marked technician is vip user boolean output field task marked technician is vip user task marked technician department object output field task marked technician department task id string unique identifier output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"task" {"percentage completion" "30","request" {},"estimated effort hours" "20","attachments" \[],"email before" "3600000","description" "the srs must contain all the requirements for the feature","title" "create srs","marked technician" {},"id" "1812392449864730","actual start time" {},"associated entity" "request","module" "request","priority" {}}}} 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 path parameters request id number required parameters for the get request task worklog action path parameters task id number required parameters for the get request task worklog action path parameters worklog id number required parameters for the get request task worklog action parameters owner string optional parameters for the get request task worklog action parameters description string optional parameters for the get request task worklog action parameters start time object optional parameters for the get request task worklog action parameters start time value string optional parameters for the get request task worklog action parameters end time object optional parameters for the get request task worklog action parameters end time value string optional parameters for the get request task worklog action parameters recorded time object optional parameters for the get request task worklog action parameters recorded time value string optional parameters for the get request task worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"task id" 1904788127933512,"worklog id" 1509662054134177}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "1962124438644868"}}} 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 path parameters request id number required parameters for the get request worklog action path parameters worklog id number required parameters for the get request worklog action parameters owner string optional parameters for the get request worklog action parameters description string optional parameters for the get request worklog action parameters start time object optional parameters for the get request worklog action parameters start time value string optional parameters for the get request worklog action parameters end time object optional parameters for the get request worklog action parameters end time value string optional parameters for the get request worklog action parameters recorded time object optional parameters for the get request worklog action parameters recorded time value string optional parameters for the get request worklog action input example {"parameters" {"owner" "test owner","description" "test description","start time" {"value" "1421988300000"},"end time" {"value" "1512974940000"},"recorded time" {"value" "1478758440000"}},"path parameters" {"request id" 2443600536133958,"worklog id" 1778953679609145}} output parameter type description status code number http status code of the response reason string response reason phrase worklog object output field worklog worklog owner object output field worklog owner worklog owner email id string unique identifier worklog owner is technician boolean output field worklog owner is technician worklog owner sms mail string output field worklog owner sms mail worklog owner phone string output field worklog owner phone worklog owner name string name of the resource worklog owner mobile string output field worklog owner mobile worklog owner id string unique identifier worklog owner photo url string url endpoint for the request worklog owner is vip user boolean output field worklog owner is vip user worklog include nonoperational hours boolean output field worklog include nonoperational hours worklog end time object time value worklog end time display value string value for the parameter worklog end time value string value for the parameter worklog description string output field worklog description worklog other charge number output field worklog other charge worklog total charge number output field worklog total charge worklog created by object output field worklog created by worklog created by email id string unique identifier worklog created by is technician boolean output field worklog created by is technician worklog created by sms mail string output field worklog created by sms mail worklog created by phone string output field worklog created by phone output example {"status code" 200,"reason" "ok","response headers" {},"json body" {"worklog" {"owner" {},"include nonoperational hours"\ false,"end time" {},"description" "test description","other charge" 1343434 4333,"total charge" 1343434 4333,"created by" {},"recorded time" {},"tech charge" 1343434 4333,"time spent" {},"mark first response"\ false,"start time" {},"worklog type" {},"id" "1962124438644868"}}} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt