ServiceDesk Plus On-Demand
API Documentation BETA
Contains the column name and value to be searched for in a json object. 

Example:
 
  "search_fields":{ 
  "title ": "Telecom change", 
  "priority": "High"
}
Contains the conditions that should be matched to fetch the response. 

Example:
 

Example for conditions like A[OR](B[AND]C)
{
  "search_criteria": [
    {
      "condition": "is",
      "values": [
        {
          "name": "Open"
        }
      ],
      "logical_operator": "or",
      "children": [
        {
          "condition": "is",
          "values": [
            "Phone Call"
          ],
          "logical_operator": "and",
          "field": "mode.name"
        },
        {
          "condition": "contains",
          "values": [
            "trial"
          ],
          "logical_operator": "and",
          "field": "subject"
        }
      ],
      "field": "status"
    }
  ]
}


Example for conditions like(A[OR]B)[AND](C[OR]D)
{
  "search_criteria": [
    {
      "field": "priority",
      "condition": "is",
      "values": [
        {
          "name": "High"
        }
      ],
      "children": [
        {
          "field": "level",
          "condition": "is",
          "values": [
            {
              "name": "Tier 1"
            }
          ],
          "logical_operator": "or"
        }
      ]
    },
    {
      "field": "created_time",
      "condition": "greater than",
      "logical_operator": "and",
      "value": "1537248600000",
      "children": [
        {
          "field": "created_time",
          "condition": "lesser than",
          "value": "1537248600000",
          "logical_operator": "or"
        }
      ]
    }
  ]
}
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 )
display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.
Value in Numbers representing the “row counts”, “start index”, “estimated days”, “estimated hours” , “estimated minutes” ,“additional costs” ,“percentage of completion”.
Numerical digits which are considered to have larger values
Example: 234759602834500
A text in a plain format. No rich text or new line characters allowed.
The name of the file that is upload.
Example: “test-document.txt”
Contains the information about the file that has been uploaded.
Example:
{
 "size": "601",
 "content_type": "application/unknown-mime-type",
 "file_id": "6003",
 "name": "test-document.txt",
 "content_url": "/tasks/1974556828626/uploads/603"
 "id": "17322245500049868"
}
The site to which the parent entity is associated. { “site”:“USA” }
The request to which the task is associated.
Example:

"request": {
      "id":1234543242345234
    }
    
The change to which the task is associated.
Example:

"change": {
      "id":1234543242345234
    }
    
The project to which the task is associated.
Example:

"project": {
      "id":1234543242345234
    }
    
The milestone to which the task is associated.
Example:

"milestone": {
      "id":1234543242345234
    }
    
The change to which the task is associated.
Example:

"change": {
      "id":1234543242345234
    }
    
The request template to which the task is associated
Example:

"request_template": {
      "id":1234543242345234
    }
    
The change template to which the task is associated
Example:

"change_template": {
      "id":1234543242345234
    }
    
The project template to which the task is associated
Example:

"project_template": {
      "id":1234543242345234
    }
    
The color used to represent the entity
The color used to represent the entity
The color used to represent the entity
Represents a date/time as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 )
display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.
Example:

 {
  "value": "1477394860065"
  "display_value": "Oct 25, 2016 11:27 AM"
}
HTML is a text area where html elements can be used.
Example : “<b>Content to be display</b>”
Numerical digits which are considered to have smaller numbers.
Example : 39
These are numbers that can include contains decimals.
Example : 23.08
Represents a date as a JSON Object. Would contain the value and the display_value attributes.

value : The time in long format (No. of milliseconds from Jan 1, 1970 )
display_value : The time in a readable form in a format as personalized by the user. If not personalized, default format would be used.
Contains the resolution details of the request.
Example :

"resolution": {
     "content": "<p>Resolution content</p>"
     }
        
Contains onhold scheduling details.
Example :

"onhold_scheduler": {
   "comments": "Reasons for Onhold",
   "holded_by": {
   "email_id": "Lincoln.@zmail.com",
   "name": "Lincoln",
   "id": "1988394720325043",
   },
   "scheduled_time": {
   "display_value": "Jan 5, 2018 01:16 PM",
   "value": "1515138360000"
   },
   "change_to_status": {
     "name": "Open",
     "id": "1879737497687"
   }
   }
        
Contains closure info of the request.
Example :

"closure_info": {
   "requester_ack_comments": "Acknowledged comments",
   "requester_ack_resolution": true
    }
        
Boolean value which can have two possible values i.e false, true.
Denotes the resource data that is mapped to the request.
Example :

"resources":{
  "resource_1134245678903456": {
    "question_1123345678903342": [
      {
        "id": "1123345678903456",
        "name": "Dell Latitude E7450"
      },
      {
        "id": "29982345678900434",
        "name": "MacBook Air"
      }
    ],
    "question_1123345634524534": "xyz@zy.com",
    "question_1123345673440345": "Yes"
  }
}  
Denotes user defined field values associated to the request.
Example :

"udf_fields":{
  "udf_char1": "abc@test.com",
  "udf_char2": "Ned Stark",
  "udf_long1": "1459402730964",
  "udf_long2": "1225",
  "udf_date1": {
    "value": "1456464639051",
    "display_value": "Feb 26, 2016 11:00 AM"
  }
}
Denotes user defined field values associated to the project.
Example :

"udf_fields":{
  "udf_char1": "abc@test.com",
  "udf_char2": "Ned Stark",
  "udf_long1": "1459402730964",
  "udf_long2": "1225",
  "udf_date1": {
    "value": "1456464639051",
    "display_value": "Feb 26, 2016 11:00 AM"
  }
}
Denotes user defined field values associated to the change.
Example :

"udf_fields":{
  "udf_char1": "abc@test.com",
  "udf_char2": "Ned Stark",
  "udf_long1": "1459402730964",
  "udf_long2": "1225",
  "udf_date1": {
    "value": "1456464639051",
    "display_value": "Feb 26, 2016 11:00 AM"
  }
}
Denotes user defined field values associated to the template.
Example :

"udf_fields":{
  "udf_char1": "abc@test.com",
  "udf_char2": "Ned Stark",
  "udf_long1": "1459402730964",
  "udf_long2": "1225",
  "udf_date1": {
    "value": "1456464639051",
    "display_value": "Feb 26, 2016 11:00 AM"
  }
}
Denotes user defined field values associated to the milestone template.
Example :

"udf_fields":{
  "udf_char1": "abc@test.com",
  "udf_char2": "Ned Stark",
  "udf_long1": "1459402730964",
  "udf_long2": "1225",
  "udf_date1": {
    "value": "1456464639051",
    "display_value": "Feb 26, 2016 11:00 AM"
  }
}
The problem associated to the task
Example:

"problem": {
      "id":1234543242345234
    }
    
Contains the Time spent in hours, minutes and seconds
Example :

"time_spent": {
      "hours": "1895947530616044",
      "seconds": 46,
      "minutes": 20
    }
    

Describe how the change process will be implemented.
Example :

 "roll_out_plan": {
   "roll_out_plan_description": "Rollout plan"
 }
        
Describes how the change process will proceed if the change request were to be cancelled.
Example :

"back_out_plan": {
   "back_out_plan_description": "backout plan"
 }
        
Describes how the change process will affect the business.
Example :

"impact_details": {
    "impact_details_description": "affects user"
    }
        
Contains the team’s evaluation of the entire life cycle of the initiated change.
Example :

 "review_details": {
    "review_details_description": "review details"
   }
        
Lists the tasks involved in the change process.
Example :

 "checklist": {
   "checklist_description": "check list"
 }
 
Contains information about change closure.
Example :

"close_details": {
  "close_details_description": "close details",
  "closure_code": {
    "name": "Closed - Cancelled",
    "id": "1791511763340510"
  }
 }
        
Sequence number of the change request.
Example :

"display_id": {
      "display_value": "CH 3",
      "value": "3"
    }
        
Organisational Role configured for the approval.
Example :

"xpath": {
      "display_name": "General Manager",
      "path": "org_roles.org_ref1"
    }
        

Options to be configured while processing the approval level.
Example :

"rule": {
      "name": "sdp.approval.anyone_approves",
      "id": "1633123212595068",
      "type": "anyone_approves",
      "value": null
    }
        

Indicates the workflow execution status.
Example :

"workflow_instance_details": {
      "id": "36338920932885067",
      "status": {
        "name": "In Progress",
        "id": "6633543434595966"
      }
    }
        
Indicates the workflow execution status.
Example :

"workflow_instance": {
      "id": "36338920932885067",
      "status": {
        "name": "In Progress",
        "id": "6633543434595966"
      }
    }
        
The services that might be affected due to this change
Example :

"services": [{ "name": "test-services", "id": "234567890123456" }]

Files that are attached to the project. Maximum of 10 attachments can be attached to a project.
Example :

    "attachments": [
    {
      "content_type": "application/x-unknown-mime-type",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
    }
  ]
Files that are attached to the milestone. Maximum of 10 attachments can be attached to a milestone.
Example :

    "attachments": [
    {
      "content_type": "application/x-unknown-mime-type",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
    }
  ]

Files that are attached to the change. Maximum of 10 attachments can be attached to a change.
Example :

    "attachments": [
    {
      "content_type": "application/x-unknown-mime-type",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
    }
  ]

Files that are attached to the request. Maximum of 10 attachments can be attached to a request.
Example :

    "attachments": [
    {
      "content_type": "application/x-unknown-mime-type",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
    }
  ]
Files that are attached to the task. Maximum of 10 attachments can be attached to a tasks.
Example :

    "attachments": [
    {
      "content_type": "application/x-unknown-mime-type",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
    }
  ]

Order of the task
Example :

    "task_index":"1"
       
Roles are access permissions defined exclusively for the change module and differs for each and every change request. A Role when assigned to a user allows the user to perform tasks defined in the role for that change request alone.
Example :

"roles": [
   {
     "role": {
       "name": "Change Approver",
       "id": "100000000000021428"
      },
      "user": {
        "name": "Albert",
        "id": "100000000000024441"
      }
    }
]
       
The module to which the closure code belongs to. Allowed modules are request, change.
Example :

{
  "module":{
    "name" : "request",
    "id" : "3237392019237402"
  }
}
       

Denotes the user who created the Note.
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
Denotes the request associated to that request_note.
Example:
{
  "request": {
    "id": "234567890123456"
  }
}
The Milestone to which the comment is associated.
Example:
{
  "milestone": {
    "name": "test-milestone",
    "id": "234567890123456"
  }
}
The User who created the Milestone Comment.
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}

Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "announcement_type": {
    "name": "test-announcement_type",
    "id": "234567890123456"
  }
}

Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}

Example:
{
  "user_groups": {
    "name": "test-user_groups",
    "id": "234567890123456"
  }
}

Example:
{
  "default_project_role": {
    "name": "test-default_project_role",
    "id": "234567890123456"
  }
}

Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

Example:
{
  "workstation": {
    "name": "test-workstation",
    "id": "234567890123456"
  }
}
The permissions for the project role.
Example:
{
  "permissions": {
    "name": "test-permissions",
    "id": "234567890123456"
  }
}

Example:
{
  "sdpintegrations": {
    "name": "test-sdpintegrations",
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}

Example:
{
  "marked_technician": {
    "name": "test-marked_technician",
    "id": "234567890123456"
  }
}

Example:
{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

Example:
{
  "marked_group": {
    "name": "test-marked_group",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

Example:
{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}

Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

Example:
{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}

Example:
{
  "connector": {
    "name": "test-connector",
    "id": "234567890123456"
  }
}

Example:
{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

Example:
{
  "permissions": {
    "name": "test-permissions",
    "id": "234567890123456"
  }
}
The project associated to the project member
Example:
{
  "project": {
    "id": "234567890123456"
  }
}
The user who will be referred as project member
Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}
The role of the project member
Example:
{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}

Example:
{
  "marked_technician": {
    "name": "test-marked_technician",
    "id": "234567890123456"
  }
}

Example:
{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}

Example:
{
  "marked_group": {
    "name": "test-marked_group",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

Example:
{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
The task to which the comment is associated
Example:
{
  "task": {
    "name": "test-task",
    "id": "234567890123456"
  }
}
The user who created the comment
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}

Example:
{
  "actions": {
    "name": "test-actions",
    "id": "234567890123456"
  }
}

Example:
{
  "currency": {
    "name": "test-currency",
    "id": "234567890123456"
  }
}

Example:
{
  "action": {
    "name": "test-action",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

Example:
{
  "barcode_type": {
    "name": "test-barcode_type",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "barcode_generation_type": {
    "name": "test-barcode_generation_type",
    "id": "234567890123456"
  }
}

Example:
{
  "barcode_mapping_field": {
    "name": "test-barcode_mapping_field",
    "id": "234567890123456"
  }
}

Example:
{
  "commented_by": {
    "name": "test-commented_by",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
The User who created the worklog
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
The technician who works on the worklog
Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}
Worklog type allows you to record the different modes of technician’s work.
Example:
{
  "worklog_type": {
    "name": "test-worklog_type",
    "id": "234567890123456"
  }
}
Denotes the Project type for the Project that will be created with this Project template
Example:
{
  "project_type": {
    "name": "test-project_type",
    "id": "234567890123456"
  }
}
Denotes the Priority for the Project that will be created with this Project template
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
Denotes the Status for the Project that will be created with this Project template
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
Denotes the user who created the Project Template
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
Denotes the Type of the Project.
Example:
{
  "project_type": {
    "name": "test-project_type",
    "id": "234567890123456"
  }
}
The user who created the Project
Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}
Denotes the priority of the Project.
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
Denotes the status of the Project.
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
Denotes the Project Template with which the Project has been created.
Example:
{
  "project_template": {
    "name": "test-project_template",
    "id": "234567890123456"
  }
}
Denotes the user who created the Project.
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
Denotes the site to which the Project belongs.
Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "depreciation_type": {
    "name": "test-depreciation_type",
    "id": "234567890123456"
  }
}

Example:
{
  "software": {
    "name": "test-software",
    "id": "234567890123456"
  }
}

Example:
{
  "workstation": {
    "name": "test-workstation",
    "id": "234567890123456"
  }
}

Example:
{
  "added_by": {
    "name": "test-added_by",
    "id": "234567890123456"
  }
}

Example:
{
  "constraints": {
    "name": "test-constraints",
    "id": "234567890123456"
  }
}

Example:
{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

Example:
{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_type": {
    "name": "test-resource_type",
    "id": "234567890123456"
  }
}

Example:
{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

Example:
{
  "field": {
    "name": "test-field",
    "id": "234567890123456"
  }
}

Example:
{
  "workflow": {
    "name": "test-workflow",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

Example:
{
  "current_statement": {
    "name": "test-current_statement",
    "id": "234567890123456"
  }
}

Example:
{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

Example:
{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "close_request_status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
The Project template to which the Milestone template is associated
Example:
{
  "project_template": {
    "name": "test-project_template",
    "id": "234567890123456"
  }
}
The Priority of the Milestone Template
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
The Status of the Milestone Template
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
The User who created the Milestone template
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation_users": {
    "name": "test-escalation_users",
    "id": "234567890123456"
  }
}

Example:
{
  "orgrole_category": {
    "name": "test-orgrole_category",
    "id": "234567890123456"
  }
}

Example:
{
  "sites": {
    "name": "test-sites",
    "id": "234567890123456"
  }
}

Example:
{
  "departments": {
    "name": "test-departments",
    "id": "234567890123456"
  }
}

Example:
{
  "regions": {
    "name": "test-regions",
    "id": "234567890123456"
  }
}

Example:
{
  "groups": {
    "name": "test-groups",
    "id": "234567890123456"
  }
}

Example:
{
  "users": {
    "name": "test-users",
    "id": "234567890123456"
  }
}

Example:
{
  "network": {
    "name": "test-network",
    "id": "234567890123456"
  }
}

Example:
{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

Example:
{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}
The project associated to the project comment
Example:
{
  "project": {
    "id": "234567890123456"
  }
}
The user who created the comment
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "permissions": {
    "name": "test-permissions",
    "id": "234567890123456"
  }
}

Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "criteria_action_id": {
    "name": "test-criteria_action_id",
    "id": "234567890123456"
  }
}

Example:
{
  "actions": {
    "name": "test-actions",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "problem": {
    "name": "test-problem",
    "id": "234567890123456"
  }
}

Example:
{
  "sdpintegrations": {
    "name": "test-sdpintegrations",
    "id": "234567890123456"
  }
}

Example:
{
  "purchase_order": {
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}

Example:
{
  "type": {
    "name": "test-type",
    "id": "234567890123456"
  }
}

Example:
{
  "action": {
    "name": "test-action",
    "id": "234567890123456"
  }
}

Example:
{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

Example:
{
  "solution": {
    "name": "test-solution",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}
Approval level to which the approval is associated
Example:
{
  "approval_level": {
    "id": "234567890123456"
  }
}
Status of the Approval
Example:
{
  "status": {
    "name": "Approved",
    "id": "234567890123456"
  }
}
Approver of the approval
Example:
{
  "approver": {
    "email_id": "andrews@zmail.com",
    "name": "test-approver",
    "id": "234567890123456"
  }
}

Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

Example:
{
  "sites": {
    "name": "test-sites",
    "id": "234567890123456"
  }
}

Example:
{
  "groups": {
    "name": "test-groups",
    "id": "234567890123456"
  }
}

Example:
{
  "roles": {
    "name": "test-roles",
    "id": "234567890123456"
  }
}

Example:
{
  "default_project_role": {
    "name": "test-default_project_role",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation_users": {
    "name": "test-escalation_users",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_type": {
    "name": "test-resource_type",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_category": {
    "name": "test-resource_category",
    "id": "234567890123456"
  }
}

Example:
{
  "asset": {
    "name": "test-asset",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_cost_factor": {
    "name": "test-resource_cost_factor",
    "id": "234567890123456"
  }
}

Example:
{
  "sdpintegrations": {
    "name": "test-sdpintegrations",
    "id": "234567890123456"
  }
}

Example:
{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

Example:
{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

Example:
{
  "maintenance_vendor": {
    "name": "test-maintenance_vendor",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}

Example:
{
  "reported_by": {
    "name": "test-reported_by",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}

Example:
{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

Example:
{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

Example:
{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}

Example:
{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

Example:
{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

Example:
{
  "attached_by": {
    "name": "test-attached_by",
    "id": "234567890123456"
  }
}

Example:
{
  "protocol": {
    "name": "test-protocol",
    "id": "234567890123456"
  }
}

Example:
{
  "currency": {
    "name": "test-currency",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "module_type": {
    "name": "test-module_type",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "last_updated_by": {
    "name": "test-last_updated_by",
    "id": "234567890123456"
  }
}

Example:
{
  "performed_by": {
    "name": "test-performed_by",
    "id": "234567890123456"
  }
}

Example:
{
  "operational_hours": {
    "name": "test-operational_hours",
    "id": "234567890123456"
  }
}

Example:
{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}

Example:
{
  "protocol": {
    "name": "test-protocol",
    "id": "234567890123456"
  }
}

Example:
{
  "connector": {
    "name": "test-connector",
    "id": "234567890123456"
  }
}

Example:
{
  "performed_by": {
    "name": "test-performed_by",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "fr_escalation": {
    "name": "test-fr_escalation",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation": {
    "name": "test-escalation",
    "id": "234567890123456"
  }
}

Example:
{
  "service_category": {
    "name": "test-service_category",
    "id": "234567890123456"
  }
}

Example:
{
  "user_groups": {
    "name": "test-user_groups",
    "id": "234567890123456"
  }
}

Example:
{
  "support_groups": {
    "name": "test-support_groups",
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "sla": {
    "name": "test-sla",
    "id": "234567890123456"
  }
}

Example:
{
  "source_statement": {
    "name": "test-source_statement",
    "id": "234567890123456"
  }
}

Example:
{
  "target_statement": {
    "name": "test-target_statement",
    "id": "234567890123456"
  }
}

Example:
{
  "dependson": {
    "name": "test-dependson",
    "id": "234567890123456"
  }
}

Example:
{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "problem": {
    "name": "test-problem",
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "layouts": {
    "name": "test-layouts",
    "id": "234567890123456"
  }
}

Example:
{
  "module_type": {
    "name": "test-module_type",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "graph_type": {
    "name": "test-graph_type",
    "id": "234567890123456"
  }
}

Example:
{
  "last_updated_by": {
    "name": "test-last_updated_by",
    "id": "234567890123456"
  }
}

Example:
{
  "solution": {
    "name": "test-solution",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "type": {
    "name": "test-type",
    "id": "234567890123456"
  }
}

Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}

Example:
{
  "notification": {
    "name": "test-notification",
    "id": "234567890123456"
  }
}

Example:
{
  "task": {
    "name": "test-task",
    "id": "234567890123456"
  }
}

Example:
{
  "webhook": {
    "name": "test-webhook",
    "id": "234567890123456"
  }
}

Example:
{
  "field_update": {
    "name": "test-field_update",
    "id": "234567890123456"
  }
}

Example:
{
  "custom_function": {
    "name": "test-custom_function",
    "id": "234567890123456"
  }
}

Example:
{
  "abort": {
    "name": "test-abort",
    "id": "234567890123456"
  }
}

Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

Example:
{
  "parent": {
    "name": "test-parent",
    "id": "234567890123456"
  }
}

Example:
{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}

Example:
{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}

Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}

Example:
{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

Example:
{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "problem": {
    "name": "test-problem",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "notifications": {
    "name": "test-notifications",
    "id": "234567890123456"
  }
}
Change templates helps to create customized change template forms by defining its layout for the most frequently raised change.Thus the change can be created quickly with all the needed fields filled automatically
Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}
Initiator of the change request
Example:
{
  "change_requester": {
    "name": "test-change_requester",
    "id": "234567890123456"
  }
}
The user who manages the change throughout its life cycle.
Example:
{
  "change_manager": {
    "name": "test-change_manager",
    "id": "234567890123456"
  }
}
The probable reasons why this change had to be initiated.
Example:
{
  "reason_for_change": {
    "name": "test-reason_for_change",
    "id": "234567890123456"
  }
}
Whether this involves high, low, or medium risk.
Example:
{
  "risk": {
    "name": "test-risk",
    "id": "234567890123456"
  }
}
Indicates the current stage of the change process
Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}
Indicates the status of the change corresponding to the current stage
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
Lists approval statuses responsible for moving change from Pending Approval status to Approved/Rejected
Example:
{
  "approval_status": {
    "name": "Approved",
    "id": "234567890123456"
  }
}
Describes whether this change will affect the business, department, group, or user.
Example:
{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}
Whether the request is high, low, or medium priority.
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
Assign the Category of the CIs invloved to this change, such as routers, switches, software etc
Example:
{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}
Assign the Sub Category of the involved CIs selected under Category
Example:
{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}
Assign the item belongs to the selected Category and Sub Category.
Example:
{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}
Refers to how urgent the change request is.
Example:
{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}
Indicates whether it is a minor, major, significant, or standard change
Example:
{
  "change_type": {
    "name": "test-change_type",
    "id": "234567890123456"
  }
}
Denotes the Site to which the request belongs.
Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}
The group to which the change request is assigned.
Example:
{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}
The owner of the change request.
Example:
{
  "change_owner": {
    "name": "test-change_owner",
    "id": "234567890123456"
  }
}
The services that might be affected due this change.
Example:
{
  "services": {
    "name": "test-services",
    "id": "234567890123456"
  }
}
The assets that might be affected or involved due to this change.
Example:
{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}
Roles are access permissions defined exclusively for the change module and differs for each and every change request. A Role when assigned to a user allows the user to perform tasks defined in the role for that change request alone.
Example:
{
  "roles": {
    "name": "test-roles",
    "id": "234567890123456"
  }
}
The last user who updates roll out plan
Example:
{
  "roll_out_plan_updated_by": {
    "name": "test-roll_out_plan_updated_by",
    "id": "234567890123456"
  }
}
The last user who updates back out plan
Example:
{
  "back_out_plan_updated_by": {
    "name": "test-back_out_plan_updated_by",
    "id": "234567890123456"
  }
}
The last user who updates impact details
Example:
{
  "impact_details_updated_by": {
    "name": "test-impact_details_updated_by",
    "id": "234567890123456"
  }
}
The last user who updates checklist
Example:
{
  "checklist_updated_by": {
    "name": "test-checklist_updated_by",
    "id": "234567890123456"
  }
}
The last user who updates review details
Example:
{
  "review_details_updated_by": {
    "name": "test-review_details_updated_by",
    "id": "234567890123456"
  }
}
The last user who updates close details
Example:
{
  "close_details_updated_by": {
    "name": "test-close_details_updated_by",
    "id": "234567890123456"
  }
}
Closure Code denotes the reason for closing a change request,
Example:
{
  "closure_code": {
    "name": "test-closure_code",
    "id": "234567890123456"
  }
}
Defines the complete life cycle with appropriate approvals at various stages of a change request.
Example:
{
  "workflow": {
    "name": "test-workflow",
    "id": "234567890123456"
  }
}
The complete life cycle of change from the beginning to the end
Example:
{
  "workflow_instance_details": {
    "name": "test-workflow_instance_details",
    "id": "234567890123456"
  }
}

Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

Example:
{
  "project": {
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "region": {
    "name": "test-region",
    "id": "234567890123456"
  }
}

Example:
{
  "protocol": {
    "name": "test-protocol",
    "id": "234567890123456"
  }
}

Example:
{
  "product": {
    "name": "test-product",
    "id": "234567890123456"
  }
}

Example:
{
  "product_type": {
    "name": "test-product_type",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_type": {
    "name": "test-resource_type",
    "id": "234567890123456"
  }
}

Example:
{
  "resource_state": {
    "name": "test-resource_state",
    "id": "234567890123456"
  }
}

Example:
{
  "vendor": {
    "name": "test-vendor",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "region": {
    "name": "test-region",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

Example:
{
  "suggested_owner": {
    "name": "test-suggested_owner",
    "id": "234567890123456"
  }
}
The module to which the closure code belongs to.
Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}
Status of the approval level
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
User details of the approval level creator
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
Approval associated request details
Example:
{
  "request": {
    "id": "234567890123456"
  }
}
Approval associated change details
Example:
{
  "change": {
    "id": "234567890123456"
  }
}
Approval associated purchase_order details
Example:
{
  "purchase_order": {
    "id": "234567890123456"
  }
}
Information about the change stage to which the approval is associated. The information about the change stage will be provided only if the approval is associated to that change.
Example:
{
  "change_stage": {
    "name": "test-change_stage",
    "id": "234567890123456"
  }
}
Options to be configured while processing the approval level.
Example:
{
  "rule": {
    "name": "test-rule",
    "id": "234567890123456"
  }
}
Indicates the workflow instance of the change, to which the approval level belongs to. This will be shown in response only when the workflow is associated to change.
Example:
{
  "workflow_instance": {
    "name": "test-workflow_instance",
    "id": "234567890123456"
  }
}
Indicates the statement(workflow instance) of the change to which the approval level belongs to
Example:
{
  "statement": {
    "name": "test-statement",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "sender": {
    "name": "test-sender",
    "id": "234567890123456"
  }
}

Example:
{
  "recipent": {
    "name": "test-recipent",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "topic": {
    "name": "test-topic",
    "id": "234567890123456"
  }
}

Example:
{
  "approval_status": {
    "name": "Approved",
    "id": "234567890123456"
  }
}

Example:
{
  "user_group_mapping": {
    "name": "test-user_group_mapping",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "last_updated_by": {
    "name": "test-last_updated_by",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation_users": {
    "name": "test-escalation_users",
    "id": "234567890123456"
  }
}

Example:
{
  "parent_task": {
    "name": "test-parent_task",
    "id": "234567890123456"
  }
}

Example:
{
  "child_task": {
    "name": "test-child_task",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation_users": {
    "name": "test-escalation_users",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "technicians": {
    "name": "test-technicians",
    "id": "234567890123456"
  }
}

Example:
{
  "request_add_notify": {
    "name": "test-request_add_notify",
    "id": "234567890123456"
  }
}

Example:
{
  "request_edit_notify": {
    "name": "test-request_edit_notify",
    "id": "234567890123456"
  }
}

Example:
{
  "request_unpick_notify": {
    "name": "test-request_unpick_notify",
    "id": "234567890123456"
  }
}

Example:
{
  "approval_level": {
    "id": "234567890123456"
  }
}

Example:
{
  "statement": {
    "name": "test-statement",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "module": {
    "name": "test-module",
    "id": "234567890123456"
  }
}

Example:
{
  "last_updated_by": {
    "name": "test-last_updated_by",
    "id": "234567890123456"
  }
}

Example:
{
  "workflow": {
    "name": "test-workflow",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "layouts": {
    "name": "test-layouts",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "request_template": {
    "name": "test-request_template",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}
Indicates the level of progress of the task
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
The group associated to the task
Example:
{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}
The group to be assigned when the task is triggered
Example:
{
  "marked_group": {
    "name": "test-marked_group",
    "id": "234567890123456"
  }
}
The User to whom the task is assigned.
Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}
The technician to be assigned when the task is triggered.
Example:
{
  "marked_technician": {
    "name": "test-marked_technician",
    "id": "234567890123456"
  }
}
Name and Id of the Technician who created the task is present in JSON format
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
Used to categorize the tasks of similar cases
Example:
{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

Example:
{
  "parent": {
    "name": "test-parent",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "project": {
    "id": "234567890123456"
  }
}

Example:
{
  "group_id": {
    "name": "test-group_id",
    "id": "234567890123456"
  }
}

Example:
{
  "escalation_users": {
    "name": "test-escalation_users",
    "id": "234567890123456"
  }
}

Example:
{
  "protocol": {
    "name": "test-protocol",
    "id": "234567890123456"
  }
}

Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}
User object of the user who put the request onhold.
Example:
{
  "held_by": {
    "name": "test-held_by",
    "id": "234567890123456"
  }
}
Status object to which the request is scheduled to move to, after the onhold scheduler is completed.
Example:
{
  "change_to_status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
Closure Code denotes the reason for closing a request.
Example:
{
  "closure_code": {
    "name": "test-closure_code",
    "id": "234567890123456"
  }
}
Impact of the Request.
Example:
{
  "impact": {
    "name": "test-impact",
    "id": "234567890123456"
  }
}
Indicates the current status of the request.
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
Indicates the requester of the request.
Example:
{
  "requester": {
    "email_id": "andrews@zmail.com",
    "name": "test-requester",
    "id": "234567890123456"
  }
}
Indicates the requester who created this request.
Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}
The Mode in which the request is created.
Example:
{
  "mode": {
    "name": "test-mode",
    "id": "234567890123456"
  }
}
SLA details associated with this request.
Example:
{
  "sla": {
    "name": "test-sla",
    "id": "234567890123456"
  }
}
Department to which this requester belongs.
Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}
Denotes the Site to which the request belongs.
Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}
Indicates the template which is used to create this request.
Example:
{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}
Service category to which this request belongs.
Example:
{
  "service_category": {
    "name": "test-service_category",
    "id": "234567890123456"
  }
}
Denotes the approval status of this request(Approved/Pending Approval/Rejected).
Example:
{
  "approval_status": {
    "name": "Approved",
    "id": "234567890123456"
  }
}
The group to which the request is assigned.
Example:
{
  "group": {
    "name": "test-group",
    "id": "234567890123456"
  }
}
Technician assigned to this request.
Example:
{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}
Priority of the request.
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
Level of the Request.
Example:
{
  "level": {
    "name": "test-level",
    "id": "234567890123456"
  }
}
Category to which this request belongs.
Example:
{
  "category": {
    "name": "test-category",
    "id": "234567890123456"
  }
}
Subcategory to which this request belongs.
Example:
{
  "subcategory": {
    "name": "test-subcategory",
    "id": "234567890123456"
  }
}
Item of the request.
Example:
{
  "item": {
    "name": "test-item",
    "id": "234567890123456"
  }
}
Urgency of the request
Example:
{
  "urgency": {
    "name": "test-urgency",
    "id": "234567890123456"
  }
}
Type of the Request
Example:
{
  "request_type": {
    "name": "test-request_type",
    "id": "234567890123456"
  }
}
Array of asset objects associated to the request.
Example:
{
  "assets": [
    {
      "name": "test-assets",
      "id": "234567890123456"
    }
  ]
}
Holds linked request details.
Example:
{
  "request": {
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "members": {
    "name": "test-members",
    "id": "234567890123456"
  }
}

Example:
{
  "parent_solution": {
    "name": "test-parent_solution",
    "id": "234567890123456"
  }
}

Example:
{
  "child_solution": {
    "name": "test-child_solution",
    "id": "234567890123456"
  }
}

Example:
{
  "stage": {
    "name": "test-stage",
    "id": "234567890123456"
  }
}

Example:
{
  "notification_template": {
    "name": "test-notification_template",
    "id": "234567890123456"
  }
}

Example:
{
  "cost_center": {
    "name": "test-cost_center",
    "id": "234567890123456"
  }
}

Example:
{
  "bill_address": {
    "name": "test-bill_address",
    "id": "234567890123456"
  }
}

Example:
{
  "ship_address": {
    "name": "test-ship_address",
    "id": "234567890123456"
  }
}

Example:
{
  "device_type": {
    "name": "test-device_type",
    "id": "234567890123456"
  }
}

Example:
{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

Example:
{
  "success_credential": {
    "name": "test-success_credential",
    "id": "234567890123456"
  }
}

Example:
{
  "domain": {
    "name": "test-domain",
    "id": "234567890123456"
  }
}

Example:
{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "request_templates": {
    "name": "test-request_templates",
    "id": "234567890123456"
  }
}

Example:
{
  "created_by": {
    "email_id": "andrews@zmail.com",
    "name": "test-created_by",
    "id": "234567890123456"
  }
}

Example:
{
  "department_head": {
    "name": "test-department_head",
    "id": "234567890123456"
  }
}

Example:
{
  "site": {
    "name": "test-site",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "archive_request": {
    "name": "test-archive_request",
    "id": "234567890123456"
  }
}

Example:
{
  "credential": {
    "name": "test-credential",
    "id": "234567890123456"
  }
}

Example:
{
  "probe": {
    "name": "test-probe",
    "id": "234567890123456"
  }
}
The Project to which the milestone is associated
Example:
{
  "project": {
    "id": "234567890123456"
  }
}
The User who created the Milestone
Example:
{
  "owner": {
    "name": "test-owner",
    "id": "234567890123456"
  }
}
The Priority of the milestone
Example:
{
  "priority": {
    "name": "test-priority",
    "id": "234567890123456"
  }
}
The Status of the Milestone
Example:
{
  "status": {
    "name": "Open",
    "id": "234567890123456"
  }
}
The User associated to the Milestone
Example:
{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

Example:
{
  "attachments": {
    "name": "test-attachments",
    "id": "234567890123456"
  }
}

Example:
{
  "change": {
    "id": "234567890123456"
  }
}

Example:
{
  "archive_request": {
    "name": "test-archive_request",
    "id": "234567890123456"
  }
}

Example:
{
  "technician": {
    "email_id": "andrews@zmail.com",
    "name": "test-technician",
    "id": "234567890123456"
  }
}

Example:
{
  "department": {
    "name": "test-department",
    "id": "234567890123456"
  }
}

Introduction

The ServiceDesk Plus OnDemand API allows you to perform all the operations that you do with our web client.

ServiceDesk Plus OnDemand API is built using REST principles which ensures predictable URLs that makes writing applications easy. This API follows HTTP rules, enabling a wide range of HTTP clients can be used to interact with the API.

Every resource is exposed as a URL. The URL of each resource can be obtained by accessing the API Root Endpoint.

Getting Started

To use our API you must satisfy these prerequistes

1. A valid Zoho username and password.

2. An Authentication Token - authtoken in short!

Authentication

All ServiceDesk Plus Ondemand API need to be authenticated using an authtoken.

In Your Browser

Obtaining an authtoken in your browser is very simple. Login to your Zoho Account and go to the URL below.

https://accounts.zoho.com/apiauthtoken/create?SCOPE=SDPOnDemand/sdpodapi.

Programmatically Using The API

If you have chosen to obtain your authtoken via an API, please follow the instructions given below:

Submit an HTTP POST request to the below URL.

https://accounts.zoho.com/apiauthtoken/nb/create.

The POST body should include a string in the below format.

?SCOPE=SDPOnDemand/sdpodapi&EMAIL_ID=[ZohoID/EmailID]&PASSWORD=[Password]

Below are the mandatory case sensitive fields to be passed in the URL.

Param Description
SCOPE SDPOnDemand/sdpodapi
EMAIL_ID Your Zoho ID or Email ID
PASSWORD Your Zoho password

Points To Note

1. You can manage (regenerate or delete) your active authtokens created for different Zoho Services here.

2. Authtokens do not get deleted unless you delete them from the Zoho Accounts page yourself. You do not need to create multiple authtokens to send out requests.

3. Authtokens carry important information about your identity. So make sure, you keep them secure and it is secretive.

4. It is not possible to obtain an authtoken via the Zoho Accounts API if you log in to ServiceDesk Plus Ondemand with your Google, Yahoo or any other third party accounts.

Portals

If you have multiple portals in your organization, the portal name should be mentioned in every API request to identify the portal.

/app/<portal>/api/v3/requests

<portal> - represents the name of the portal, like “itdesk” for IT Help Desk, “facilites” for Facilities Desk.

/app/itdesk/api/v3/requests

If you have multiple portals and if you don’t mention the portal name in the API request, the response for the IT Desk will be shown.

Operations

Following are the different types of API request methods,

Method Description
POST Used to add entity details
GET Used to view the entity details
PUT Used to Update/Bulk-Update the entity detail(s)
DELETE Used to Delete/Bulk-Delete the entity detail(s)

Input Data

Format


{

    "entity" :{"Entity Attributes and values"},
    "list_info": {"Attributes and values for List view kind of navigation"},
    "fields_required" : [ "list of fields required" ]
}

It is a JSON string which contain all the fields and their values. It will be passed as a parameter for required operations.

List Info

The General structure of Input Data

list_info :
{
   row_count         : number of rows to be returned(maximum row_count = 100)
   start_index        : starting row index
   sort_field           : "fieldName"
   sort_order          : “asc/desc”,
   search_fields     : { "field1" : "value", "field2" : value }, 
   get_total_count   : boolean (by default it will be false)
   has_more_rows   : boolean (will be returned with the response)
   total_count          : count (will be returned with the response only)
   search_criteria    :  Refer search criteria object given in the attributes of 
                         List Info(For performing advanced search)

}

For navigating and getting data, list_info can be provided with input_data. list_info object must be used as parameters for the requesting URL not as form data. list_info object should be encoded. list_info object can only be used for get all(get list). Fields available for list_info are

start_index
Use this to get a list of tasks starting from this index.
e.g: 6
row_count
Use this to mention the number of rows that needs to be returned.
e.g: 15
search_fields
The column name and value to be searched for in the format of a json object.
e.g {“title”:“Change like this”,“priority”:“High”}
search_criteria
The column name and the value with specific conditions(Conditions that can be given are “is, is not, lesser than, greater than, lesser or equal, greater or equal, contains, not contains, starts with, ends with, between”) to be searched.
e.g {field:‘project.id’,condition:'is’,value:project_id}
sort_field
The column name for the sorting functionality
e.g:requester
sort_order
The sorting order, either ascending or descending.
e.g: asc or desc
has_more_rows
Indicates whether there are more rows or not.
e.g: true, false
get_total_count
Indicates whether to get the total count of data or not.
e.g: true, false
total_count
Contains the total count of the data based on the “get_total_count” variable.
e.g: true, false
fields_required
Columns that need to be displayed in the output. JSON array must be given as input
e.g: “[title,priority]”

Response

Response will be in the JSON format. Response JSON Object contains,

Fields Description
Entity Name Contains the entity details
Response Status Status code with the success/failure message(s)
List Info Contains an Information about the entity such as row count, has_more_rows and so on

Common Error Codes

Bulk Api error response example

{
  "response_status": [
    {
      "status_code": 2000,
      "id": "100000000000066057",
      "status": "success"
    },
    {
      "status_code": 4000,
      "id": "100000000000066051",
      "status": "failed",
      "messages": [
        {
          "status_code": 4004,
          "message": "Internal Error",
          "type": "failed"
        }
      ]
    }
  ]
}

There are 2 things that we need to handle in error case.One for human and the other for api consumer (machine) to interpret and take appropriate actions. For human, a proper readable error message can be returned. For machine, based on status code and “fields” that cause the error, it can highlight appropriate things in UI or take some other action.

Error scenarioCodeHTTP codeExample response (content of response_status object)
Id or Name given in Input does not exist or not in use or user cannot set the value4001400 { “response_status”: { “messages”: [ { “status_code”: 4001, “type”: “failed”, “message”: “Value given for title is not valid” } ], “status”: “failed” } }
Forbidden / User not allowed to perform the operation4002403 { “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4002, “type”: “failed”, “message”: “User does not have this permission” } ], “status”: “failed"4 } }
Closure rule violation4003400 { "response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4003, “type”: “failed”, “message”: “Closure rule violation. The following fields should be filled title” } ], “status”: “failed” } }
Internal Error (Exact error cannot be sent to user, like some Exception)4004500{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4004, “type”: “failed” } ], “status”: “failed”{ } }
Reference Exists. (Cannot delete an entity, because it is being used in another module)4005400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4005, “field”: “id”, “type”: “failed” } ], “status”: “failed” } }
Invalid URL or Resource not founde.g., /requests/10 and if the request with id 10 not found4007404{ “response_status”: { “messages”: [ { “status_code”: 4007, “type”: “failed”, “message”: “Invalid URL” } ], “status”: “failed” } }
Not Unique4008400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4008, “field”: “name”, “type”: “failed” } ], “status”: “failed” } }
Trying to edit non-editable field(value for certain fields can be given during add but cannot be edited e.g., status in_progress)4009400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4009, “field”: “project_template”, “type”: “failed” } ], “status”: “failed” } }
Trying to edit internal field4010400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4010, “type”: “failed”, “message”: “Trying to edit internal field: internal_name” } ], “status”: “failed” } }
No such field4011400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4011, “type”: “failed”, “message”: “No field exists with the name field_name” } ], “status”: “failed” } }
Value for mandatory-field is not provided4012400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4012, “field”: “title”, “type”: “failed” } ], “status”: “failed” } }
Unsupported Content Type4013415{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4013, “type”: “failed” } ], “status”: “failed” } }
Trying to edit read-only field4014400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4014, “field”: “created_time”, “type”: “failed” } ], “status”: “failed” } }
API Rate Limit reached4015400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4015, “type”: “failed” } ], “status”: “failed” } }
Already in Trash4016400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4016, “type”: “failed”, “message”: “Request is already in trash” } ], “status”: “failed” } }
Not In Trash4017400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 4017, “type”: “failed” } ], “status”: “failed” } }
Not allowed as per current license7001400{ “response_status”: { “status_code”: 4000, “messages”: [ { “status_code”: 7001, “type”: “failed”, “message”: “Cannot perform the intended operation as per current lisence” } ], “status”: “failed” } }

Requests

The numerous help desk tickets raised in your organization are organized and tracked in the Requests module. The Requests module enables you to handle tickets promptly, assign tickets to technicians, merge similar requests and so on.



Request

End user can raise a request when he find disruption of existing service offered to him or he can raise a request for a new service.

All Attributes
id

Id of this request

subject

Subject of this request[Max-length : 250]

description

Description of this request

impact_details

Description about the impact of this request[Max-length : 250]

resolution

A solution for the request, provided by the technician

content

Resolution content provided by the technician to resolve this request.

time_elapsed
LONG(Read-Only)

Indicates the time spent on this request

email_cc
STRING(Read-Only)

List of e-mail addresses(cc addresses) which receives the request through e-mail.

email_ids_to_notify

Array of Email ids, which needs to be notified about the happenings of this request

update_reason

The reason for updating this request[Max-length : 250]

email_to
STRING(Read-Only)

List of email addresses(to addresses) which receives the request

email_bcc
STRING(Read-Only)

List of email addresses(bcc addresses) which receives the request

onhold_scheduler

Contains the scheduling details for the request, when the request is in Onhold status

scheduled_time

Denotes the scheduled time for the onhold scheduler to change the Request’s status

comments

Comments added for linking requests[Max-length : 250]

held_by
REFERRED_FIELD(Read-Only)

The technician who stopped the timer/who changed the status to OnHold of the Request

change_to_status

Status object to which the request is scheduled to move to, after the onhold scheduler is completed.

closure_info

Contains the closure information when the request is in Closed status

requester_ack_resolution

Denotes if the requester has acknowledged the resolution he/she has been given.

requester_ack_comments

Comments from the requester in regards to the resolution he/she has been given[Max-length : 250]

closure_code

Closure Codes are codes that denote the reason for closing a request(ticket)/change request, whether the request/change was closed due to completion, rejection, and so on

closure_comments

Closure comments denotes the reason for closing the request. Closure comments can only be given by technician.

impact

Impact of this request

status

Indicates the current status of this request

display_id
LONG(Read-Only)

Display id of this request

requester

Indicates the requester of this request

created_by
REFERRED_FIELD(Read-Only)

Indicates the requester who created this request

created_time

Indicates the time at which this request is created

responded_time
DATETIME(Read-Only)

Indicates the time at which this request is responded

due_by_time

Indicates the time at which this request is scheduled to be completed

completed_time
DATETIME(Read-Only)

Indicates the time at which this request is completed

mode

The mode in which this request is created

sla
REFERRED_FIELD(Read-Only)

SLA details associated with this request

department
REFERRED_FIELD(Read-Only)

Department to which this requester belongs

site

Denotes the site to which this request belongs

deleted_time
DATETIME(Read-Only)

Denotes the time at which the request will be deleted

template

Indicates the template which is used to create this request

first_response_due_by_time

Indicates the time at which the first response for this request is scheduled

service_category

Service category to which this request belongs

is_service_request
BOOLEAN(Read-Only)

Boolean value indicating whether this request is a service request or not

resolved_time
DATETIME(Read-Only)

Indicates the time at which this request is resolved

last_updated_time
DATETIME(Read-Only)

Indicates the time when this request is last updated

is_overdue
BOOLEAN(Read-Only)

Boolean value indicating whether this request is overdue

is_first_response_overdue
BOOLEAN(Read-Only)

Boolean value indicating whether this request is in overdue to make first response

is_escalated
BOOLEAN(Read-Only)

A boolean value which represents whether the request is escalated or not

is_read
BOOLEAN(Read-Only)

Boolean value indicating whether this request’s replies are read or not

is_fcr

Boolean value indicating if the request has been marked as First Call Resolution

notification_status
STRING(Read-Only)

Shows the current status of request’s replies, whether last one from requester or technician

approval_status
REFERRED_FIELD(Read-Only)

Denotes the approval status of this request.(Approved/Pending Approval/Rejected)

group

The group to which the request is assigned to

technician

Technician assigned to this request

assigned_time
DATETIME(Read-Only)

Indicates the time at which this request is assigned to a technician

priority

Priority of the request

level

Level of the request

category

Category to which the request belongs

subcategory

Subcategory to which the request belongs

item

Item of the request

urgency

Urgency of the request

request_type

Type of the request

assets

Array of asset objects associated to this request

deleted_assets
STRING(Read-Only)

The assets that are disassociated from this request

has_attachments
BOOLEAN(Read-Only)

Boolean value indicating whether this request has any attachments or not

has_notes
BOOLEAN(Read-Only)

Boolean value indicating whether this request has any notes or not

has_linked_requests
BOOLEAN(Read-Only)

Boolean value indicating whether this request has any linked requests or not

has_project
BOOLEAN(Read-Only)

Boolean value indicating whether this request is associated to a project or not

has_problem
BOOLEAN(Read-Only)

Boolean value indicating whether this request is associated to a problem or not

has_request_initiated_change
BOOLEAN(Read-Only)

Boolean value indicating whether this request is initiated a change or not

has_purchase_orders
BOOLEAN(Read-Only)

Boolean value indicating whether this request is associated to Purchase Order(s)

has_draft
BOOLEAN(Read-Only)

Boolean value indicating whether this request has drafts or not

is_reopened
BOOLEAN(Read-Only)

Boolean value indicating whether this request is reopened or not

is_trashed
BOOLEAN(Read-Only)

Boolean value indicating whether this request is in trash

linked_to_request

Holds linked request details

request
REFERRED_FIELD(Read-Only)

End user can raise a request when he find disruption of existing service offered to him or he can raise a request for a new service.

udf_fields

Holds udf fields’ values associated with the request

attachments

Files that are attached to the request. Maximum of 10 files can be attached to a request.

resources

Holds the resource data mapped to the request

status_change_comments

The reason why the status is changed

Add Request

POST /api/v3/requests

Request Example

$ curl /api/v3/requests \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "request": {
    "subject": "Need an External Monitor",
    "resolution": {
      "content": "The following is the resolution to the above request"
    },
    "mode": {
      "name": "E-Mail",
      "id": "2336191167865481"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "1970969547272879"
      }
    ],
    "group": {
      "name": "Hardware Problems",
      "id": "2295037038334745"
    },
    "requester": {
      "name": "Lincoln",
      "id": "2018123008886095"
    },
    "item": {
      "name": "Install",
      "id": "2291314553885307"
    },
    "level": {
      "name": "Tier 1",
      "id": "1755259194835321"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2340568566336011"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2114698012393029"
    },
    "priority": {
      "name": "High",
      "id": "2209836561267741"
    },
    "udf_fields": {
      "udf_long1": "1526625132944623",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1790551406109352"
    },
    "status": {
      "name": "Open",
      "id": "2441786335393762"
    },
    "template": {
      "name": "Default Template",
      "id": "1969575457784773"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "request_type": {
      "name": "Incident",
      "id": "1694513842220397"
    },
    "description": "Provide me an External Monitor",
    "urgency": {
      "name": "Urgent",
      "id": "1702827110285789"
    },
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2232527373827349"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2028978766557027"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1667607917646073"
        }
      }
    },
    "technician": {
      "name": "Charles",
      "id": "1790555943230558"
    },
    "site": {
      "name": "Custom Site",
      "id": "2132655117947039"
    },
    "category": {
      "name": "Software",
      "id": "1786417834328270"
    }
  }
}

Response Example

{
  "request": {
    "subject": "Need an External Monitor",
    "resolution": {
      "content": "The following is the resolution to the above request"
    },
    "is_read": false,
    "mode": {
      "name": "E-Mail",
      "id": "2336191167865481"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "1970969547272879"
      }
    ],
    "is_trashed": false,
    "id": "1519787543280242",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "2295037038334745"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2018123008886095",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "2291314553885307"
    },
    "level": {
      "name": "Tier 1",
      "id": "1755259194835321"
    },
    "approval_status": {
      "name": "Approved",
      "id": "1792287824153136"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2340568566336011"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2114698012393029"
    },
    "sla": {
      "name": "High",
      "id": "2366616978836730"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2209836561267741"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1722457480470196",
      "photo_url": "test-photo_url"
    },
    "first_response_due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_escalated": false,
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "has_notes": false,
    "udf_fields": {
      "udf_long1": "1526625132944623",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1790551406109352"
    },
    "email_cc": [
      "andrews@zmail.com"
    ],
    "deleted_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "2441786335393762"
    },
    "template": {
      "name": "Default Template",
      "id": "1969575457784773"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "1694513842220397"
    },
    "display_id": "39",
    "time_elapsed": "1637440171030025",
    "notification_status": "test-notification_status",
    "has_purchase_orders": false,
    "description": "Provide me an External Monitor",
    "responded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_service_request": false,
    "urgency": {
      "name": "Urgent",
      "id": "1702827110285789"
    },
    "has_request_initiated_change": false,
    "department": {
      "name": "Administration",
      "id": "2300871162476872"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2232527373827349"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2028978766557027"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1667607917646073"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "1790555943230558"
    },
    "has_problem": false,
    "due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "has_project": false,
    "site": {
      "name": "Custom Site",
      "id": "2132655117947039"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "1786417834328270"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add request.

Mandatory Fields :- <subject>

Show All Attributes

Update Request

PUT /api/v3/requests/{request_id}

Request Example

$ curl /api/v3/requests/{request_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "request": {
    "template": {
      "name": "Default Template",
      "id": "2313545787626850"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "request_type": {
      "name": "Incident",
      "id": "1845257553758857"
    },
    "subject": "Need an External Monitor",
    "description": "Provide me an External Monitor",
    "resolution": {
      "content": "The following is the resolution to the above request"
    },
    "mode": {
      "name": "E-Mail",
      "id": "2100660598472633"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2205303054854893"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "2283718773053744"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1627885971064737"
    },
    "requester": {
      "name": "Lincoln",
      "id": "2208448512064487"
    },
    "created_time": {
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1591055300986787"
    },
    "level": {
      "name": "Tier 1",
      "id": "2387139231007599"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1583376480969811"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "1768452727694542"
    },
    "update_reason": "The request is updated for this reason",
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "1601735445158323"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "1518615394099105"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1839471026485830"
        }
      }
    },
    "technician": {
      "name": "Charles",
      "id": "2177070469204481"
    },
    "priority": {
      "name": "High",
      "id": "2454587896572871"
    },
    "due_by_time": {
      "value": "1478758440000"
    },
    "first_response_due_by_time": {
      "value": "1478758440000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2290778920867254"
    },
    "udf_fields": {
      "udf_long1": "2415002036472048",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2320493933036817"
    },
    "category": {
      "name": "Software",
      "id": "2255843949428315"
    },
    "status": {
      "name": "Open",
      "id": "2093543138464146"
    }
  }
}

Response Example

{
  "request": {
    "subject": "Need an External Monitor",
    "resolution": {
      "content": "The following is the resolution to the above request"
    },
    "is_read": false,
    "mode": {
      "name": "E-Mail",
      "id": "2100660598472633"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2205303054854893"
      }
    ],
    "is_trashed": false,
    "id": "2388744440715553",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "1627885971064737"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2208448512064487",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1591055300986787"
    },
    "level": {
      "name": "Tier 1",
      "id": "2387139231007599"
    },
    "approval_status": {
      "name": "Approved",
      "id": "1718295929627616"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1583376480969811"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "1768452727694542"
    },
    "update_reason": "The request is updated for this reason",
    "sla": {
      "name": "High",
      "id": "1695369486883455"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2454587896572871"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2134014869268513",
      "photo_url": "test-photo_url"
    },
    "first_response_due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_escalated": false,
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "has_notes": false,
    "udf_fields": {
      "udf_long1": "2415002036472048",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2320493933036817"
    },
    "email_cc": [
      "andrews@zmail.com"
    ],
    "deleted_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "2093543138464146"
    },
    "template": {
      "name": "Default Template",
      "id": "2313545787626850"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "1845257553758857"
    },
    "display_id": "39",
    "time_elapsed": "1576537331443769",
    "notification_status": "test-notification_status",
    "has_purchase_orders": false,
    "description": "Provide me an External Monitor",
    "responded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_service_request": false,
    "urgency": {
      "name": "Urgent",
      "id": "2283718773053744"
    },
    "has_request_initiated_change": false,
    "department": {
      "name": "Administration",
      "id": "2270944140898062"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "1601735445158323"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "1518615394099105"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1839471026485830"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "2177070469204481"
    },
    "has_problem": false,
    "due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_fcr": false,
    "has_project": false,
    "site": {
      "name": "Custom Site",
      "id": "2290778920867254"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "2255843949428315"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update request.

Show All Attributes

Delete Request

DELETE /api/v3/requests/{request_id}

Request Example

$ curl /api/v3/requests/{request_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete request.

Get Request

GET /api/v3/requests/{request_id}

Request Example

$ curl /api/v3/requests/{request_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "request": {
    "subject": "Need an External Monitor",
    "resolution": {
      "add_to_linked_requests": false,
      "content": "The following is the resolution to the above request"
    },
    "is_read": false,
    "mode": {
      "name": "E-Mail",
      "id": "1525072917422872"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2168741485467829"
      }
    ],
    "is_trashed": false,
    "id": "2263398092139473",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "1927002194470551"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2407662461371170",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1641499800323598"
    },
    "level": {
      "name": "Tier 1",
      "id": "1852105859016972"
    },
    "approval_status": {
      "name": "Approved",
      "id": "2333046044523470"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1486283772019191"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2395926312615764"
    },
    "update_reason": "The request is updated for this reason",
    "sla": {
      "name": "High",
      "id": "1844312146294375"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1712104683380926"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2244975596696018",
      "photo_url": "test-photo_url"
    },
    "first_response_due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_escalated": false,
    "last_updated_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "has_notes": false,
    "udf_fields": {
      "udf_long1": "2098078399946504",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2406744068936403"
    },
    "email_cc": [
      "andrews@zmail.com"
    ],
    "deleted_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1901443391559330"
    },
    "template": {
      "name": "Default Template",
      "id": "2273009844454638"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "2119021456851480"
    },
    "display_id": "39",
    "time_elapsed": "2222361261795297",
    "notification_status": "test-notification_status",
    "has_purchase_orders": false,
    "description": "Provide me an External Monitor",
    "responded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_service_request": false,
    "deleted_assets": [
      {
        "IAMArray": "test-IAMArray"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "2340563334136463"
    },
    "has_request_initiated_change": false,
    "request_template_task_ids": [
      {
        "id": "1965765983648325",
        "title": "Create SRS"
      }
    ],
    "department": {
      "name": "Administration",
      "id": "1816628431948862"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "1510218169882231"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2262747033659556"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1618945964514979"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "2249313827648792"
    },
    "delete_pre_template_tasks": false,
    "has_problem": false,
    "due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "is_fcr": false,
    "has_project": false,
    "site": {
      "name": "Custom Site",
      "id": "1922141498405345"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "1493288090047889"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get request.

Show All Attributes

Get All Requests

GET /api/v3/requests

Request Example

$ curl /api/v3/requests \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "requests": [
    {
      "subject": "Need an External Monitor",
      "is_read": false,
      "id": "1881807896484221",
      "group": {
        "site": "Custom Site",
        "name": "Hardware Problems",
        "id": "1906511768686286"
      },
      "requester": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2082197052716344",
        "photo_url": "test-photo_url"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "approval_status": {
        "name": "Approved",
        "id": "2454127093084810"
      },
      "update_reason": "The request is updated for this reason",
      "sla": {
        "name": "High",
        "id": "1518987895517989"
      },
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "1810394963412566"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1834027853886082",
        "photo_url": "test-photo_url"
      },
      "first_response_due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "has_notes": false,
      "status": {
        "in_progress": false,
        "internal_name": "test-internal_name",
        "color": "#ffffff",
        "name": "Open",
        "id": "2206930880793188"
      },
      "template": {
        "name": "Default Template",
        "id": "2411406625796295"
      },
      "display_id": "39",
      "notification_status": "test-notification_status",
      "description": "Provide me an External Monitor",
      "responded_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "is_service_request": false,
      "urgency": {
        "name": "Urgent",
        "id": "2474229381690349"
      },
      "has_attachments": false,
      "is_overdue": false,
      "technician": {
        "email_id": "test@test.com",
        "cost_per_hour": 1343434.4333,
        "name": "Charles",
        "id": "2045562003500436"
      },
      "delete_pre_template_tasks": false,
      "due_by_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "is_fcr": false,
      "site": {
        "name": "Custom Site",
        "id": "2143769612536312"
      },
      "is_first_response_overdue": false
    }
  ]
}

This operation helps you Get all requests.

Show All Attributes

Add Attachment To A Request

POST api/v3/requests/{request_id}/uploads
$ curl api/v3/requests/{request_id}/uploads \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -F "filename=@local_file_path" -F "addtoattachment=true"

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "files": [
    {
      "content_type": "application/zip",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
      "content_url": "/requests/1234233323423432/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a request. Here, the input must be given as multipart - form data.

Mandatory Fields :- <filename>

All Attributes
filename
The path of the file to be uploaded must be given with ’@’ at the beginning of the path
addtoattachment
Denotes whether to add the file as an attachment to the associated entity
The details of the file is contained here
size
The size of the file that is uploaded
content_type
The type of the content of the file
file_id
The file_id is used to add that file as an attachment to the entity
name
The name of the file
content_url
The url of the file that is uploaded

Request Note

When you would like to add some additional information including technical information to a particular request based on your observations, you can use notes. You can also use notes to update the status of the request.

All Attributes
id

Id of the Note

description

Indicates the description of the Note

created_by
REFERRED_FIELD(Read-Only)

Denotes the user who created the Note

created_time
DATETIME(Read-Only)

Indicates the created time of the Note

show_to_requester

Represents whether to show the note to requester or not

request
REFERRED_FIELD(Read-Only)

Denotes the request associated to that request note

notify_technician

Represents whether to notify the technician or not

mark_first_response

Indicates whether to set the responded date of the request/ticket

add_to_linked_requests

Represents whether to add the note to the linked requests

Add Note

POST /api/v3/requests/{request_id}/notes

Request Example

$ curl /api/v3/requests/{request_id}/notes \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "request_note": {
    "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"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "request_note": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "request": {
      "display_id": "39",
      "subject": "Need an External Monitor",
      "id": "1927707738203598"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "2289555189077060",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1761720018112730",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Add note.

Mandatory Fields :- <description>

Show All Attributes

Update Note

PUT /api/v3/requests/{request_id}/notes/{request_note_id}

Request Example

$ curl /api/v3/requests/{request_id}/notes/{request_note_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "request_note": {
    "notify_technician": false,
    "show_to_requester": false,
    "description": "The following is the note for the associated request"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "request_note": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "request": {
      "display_id": "39",
      "subject": "Need an External Monitor",
      "id": "2392549854699834"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "2386071018301996",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1534769753851924",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Update note.

Show All Attributes

Delete Note

DELETE /api/v3/requests/{request_id}/notes/{request_note_id}

Request Example

$ curl /api/v3/requests/{request_id}/notes/{request_note_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete note.

Get Note

GET /api/v3/requests/{request_id}/notes/{request_note_id}

Request Example

$ curl /api/v3/requests/{request_id}/notes/{request_note_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "request_note": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "request": {
      "display_id": "39",
      "subject": "Need an External Monitor",
      "id": "2388120228840371"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "1840223183673768",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2010271170330236",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Get note.

Show All Attributes

Get All Notes

GET /api/v3/requests/{request_id}/notes

Request Example

$ curl /api/v3/requests/{request_id}/notes \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "notes": [
    {
      "mark_first_response": false,
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "add_to_linked_requests": false,
      "request": {
        "display_id": "39",
        "subject": "Need an External Monitor",
        "id": "1492277641761789"
      },
      "notify_technician": false,
      "show_to_requester": false,
      "description": "The following is the note for the associated request",
      "id": "1892133742745838",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1699927750278786",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all notes.

Show All Attributes

Approval Level

The approvals are added to the entity Request in different level. This entity represents the level of the approval.

All Attributes
id

Primary id for approval level

level

Level number of the approval level

status
REFERRED_FIELD(Read-Only)

Status of the approval level

created_time
DATETIME(Read-Only)

Approval level created time

created_by
REFERRED_FIELD(Read-Only)

User details of the approval level creator

associated_entity
STRING(Read-Only)

Holds the value of this approval belongs to which entity [request, purchase_order, change]

request
REFERRED_FIELD(Read-Only)

Information about the request to which the approval is associated.  The information about the request will be provided only if the approval is associated to that request.

change
REFERRED_FIELD(Read-Only)

Information about the change to which the approval is associated.  The information about the change will be provided only if the approval is associated to that change.

purchase_order
REFERRED_FIELD(Read-Only)

Information about the pruchase order to which the approval is associated.  The information about the pruchase order will be provided only if the approval is associated to that pruchase order.

change_stage

Information about the change stage to which the approval is associated.  The information about the change stage will be provided only if the approval is associated to a change.

rule

Options to be configured while processing the approval level. Available options are,

1. Anyone to Approve - If any of the approvers approves, the approval is approved. If all reject, the approval is rejected.

2. Everyone to approve - If everyone of the approvers approves, the approval is approved. If anybody rejects, the approval is rejected.

3. First response action - If the first one to respond to the approval approves, the approval is approved. If he rejects, the approval is rejected

workflow_instance
REFERRED_FIELD(Read-Only)

Indicates the workflow instance of the change, to which the approval level belongs to. This will be shown in response only when the workflow is associated to change.

statement
REFERRED_FIELD(Read-Only)

Indicates the statement(workflow instance) of the change to which the approval level belongs to

Add Request Approval Level

POST /api/v3/requests/{request_id}/approval_levels

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval_level": {
    "level": "1"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval_level": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "request": {
      "display_id": "39",
      "subject": "Need an External Monitor",
      "id": "1616420049573426"
    },
    "level": "1",
    "associated_entity": "request",
    "rule": {
      "name": "sdp.approval.everyone_approves",
      "id": "2265490414408594",
      "type": "everyone_approves",
      "value": "1478758440000"
    },
    "id": "1842194762413385",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1578000382843765",
      "photo_url": "test-photo_url"
    },
    "status": {
      "name": "To be Sent",
      "id": "2476922526199106"
    }
  }
}

This operation helps you Add request approval level.

Show All Attributes

Delete Request Approval Level

DELETE /api/v3/requests/{request_id}/approval_levels/{approval_level_id}

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete request approval level.

Get Request Approval Level

GET /api/v3/requests/{request_id}/approval_levels/{approval_level_id}

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval_level": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "request": {
      "display_id": "39",
      "subject": "Need an External Monitor",
      "id": "2033087129232818"
    },
    "level": "1",
    "associated_entity": "request",
    "rule": {
      "name": "sdp.approval.everyone_approves",
      "id": "2228626584936497",
      "type": "everyone_approves",
      "value": "1478758440000"
    },
    "id": "2407159533889406",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2157582954161921",
      "photo_url": "test-photo_url"
    },
    "status": {
      "name": "To be Sent",
      "id": "1789397884257791"
    }
  }
}

This operation helps you Get request approval level.

Show All Attributes

Get All Request Approval Levels

GET /api/v3/requests/{request_id}/approval_levels

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "approval_levels": [
    {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "request": {
        "display_id": "39",
        "subject": "Need an External Monitor",
        "id": "1907514752203518"
      },
      "level": "1",
      "associated_entity": "request",
      "rule": {
        "name": "sdp.approval.everyone_approves",
        "id": "1822104139188929",
        "type": "everyone_approves",
        "value": "1478758440000"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1750944246824302",
        "photo_url": "test-photo_url"
      },
      "id": "1734103992877705",
      "status": {
        "name": "To be Sent",
        "id": "2287817200475058"
      }
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all request approval levels.

Show All Attributes

Approval

The raised ticket can be sent for approval from the authorized users or higher authority

All Attributes
id

Id of the approval

approval_level
REFERRED_FIELD(Read-Only)

Approval level to which the approval is associated

status
REFERRED_FIELD(Read-Only)

Status of the Approval

sent_on
DATETIME(Read-Only)

Date at which the approval is being sent

action_taken_on
DATETIME(Read-Only)

Date at which the action on the approval is taken

approver

Approver of the approval

comments

Comments given on the approval by the approver [Max-length : 250]

Organisational Roles configured for the approval

path

The path of the organisational role to be configured for the approval

display_name
STRING(Read-Only)

The display name of the organisational role. For Example: CEO, CFO.

Add Request Approval

POST /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "approver": {
      "name": "Lincoln",
      "id": "2259331570419529"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval": {
    "approver": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2259331570419529",
      "photo_url": "test-photo_url"
    },
    "xpath": null,
    "comments": "Comments for why this entity is approved/rejected",
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "request": {
        "id": "573363737610000"
      },
      "level": "1",
      "associated_entity": "request",
      "id": "1582279109690945",
      "created_by": {
        "id": "163363737611449"
      },
      "status": {
        "id": "573363737611449"
      }
    },
    "id": "2194773872625690",
    "sent_on": null,
    "action_taken_on": null,
    "status": {
      "name": "To be Sent",
      "id": "1828323165014223"
    }
  }
}

This operation helps you Add request approval.

Show All Attributes

Delete Request Approval

DELETE /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete request approval.

Get Request Approval

GET /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval": {
    "approver": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2211378041392294",
      "photo_url": "test-photo_url"
    },
    "xpath": null,
    "comments": "Comments for why this entity is approved/rejected",
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "request": {
        "id": "573363737610000"
      },
      "level": "1",
      "associated_entity": "request",
      "id": "1886574551696383",
      "created_by": {
        "id": "163363737611449"
      },
      "status": {
        "id": "573363737611449"
      }
    },
    "id": "1814871839560603",
    "sent_on": null,
    "action_taken_on": null,
    "status": {
      "name": "To be Sent",
      "id": "1811279054491740"
    }
  }
}

This operation helps you Get request approval.

Show All Attributes

Get All Request Approvals

GET /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "approvals": [
    {
      "approver": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1864266719789711",
        "photo_url": "test-photo_url"
      },
      "xpath": null,
      "comments": "Comments for why this entity is approved/rejected",
      "approval_level": {
        "created_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "request": {
          "id": "573363737610000"
        },
        "level": "1",
        "associated_entity": "request",
        "id": "2061748410102907",
        "created_by": {
          "id": "163363737611449"
        },
        "status": {
          "id": "573363737611449"
        }
      },
      "id": "2004511605005677",
      "sent_on": null,
      "action_taken_on": null,
      "status": {
        "name": "To be Sent",
        "id": "1985084151506791"
      }
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all request approvals.

Show All Attributes

Approve Request Approval

PUT /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/approve

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/approve \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "comments": "The comments to approve the approval"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Your decision has been recorded. Thank you for your cooperation!"
      }
    ],
    "status": "success"
  }
}

This operation helps you Approve request approval.

Show All Attributes

Reject Request Approval

PUT /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/reject

Request Example

$ curl /api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/reject \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "comments": "The comments to reject the approval"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Your decision has been recorded. Thank you for your cooperation!"
      }
    ],
    "status": "success"
  }
}

This operation helps you Reject request approval.

Show All Attributes

Get Notification Content For Sending Request Approval

GET api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification

Request Example

$ curl api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "notification": {
    "subject": "Approval required for a Request",
    "description": "Your approval is required for a Request to act upon. The details of the Request can be found at $ApprovalLink"
  }
}

This operation helps you Get notification content for sending request approval.

Show All Attributes

Send Notification For Request Approval

PUT api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification

Request Example

$ curl api/v3/requests/{request_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "notification": {
    "subject": "Approval required for a Request",
    "description": "Your approval is required for a Request to act upon. The details of the Request can be found at $ApprovalLink"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Approval Mail Sent"
      }
    ],
    "status": "success"
  }
}

This operation helps you Send notification for request approval.

Show All Attributes

Task

A task is an activity or piece of work which you have to do, usually as part of a larger request/change/project/milestone/problem.

All Attributes
id

Unique Identifier to identify the task

title

Title of the task

description

Contains description about the task

module
STRING(Read-Only)

The module to which the task belongs to

created_date
DATETIME(Read-Only)

Date and time at which the task is created

scheduled_start_time

Date and time at which the task is scheduled to start

scheduled_end_time

Date and time at which the task is scheduled to finish

actual_start_time

Date and time at which the task has actually started

actual_end_time

Date and time at which the task actually got finished

status

Indicates the level of progress of the task

group

The group associated to the task

marked_group

The group to be assigned when the task is triggered

email_before

Indicates when to send an notification before schedule start

owner

The User assigned to the task

marked_technician

The user to be assigned when the task is triggered

created_by
REFERRED_FIELD(Read-Only)

Name and Id of the user who created the task is present in JSON format

priority

Defines the intensity or importance of a task. 

site
SITE(Read-Only)

The site to which the parent entity is associated

percentage_completion

Indicates the progress of the task in percentage of completion

additional_cost

Cost spent other than the actual cost of the task

estimated_effort_days

Estimated number of days to finish the task

estimated_effort_hours

Estimated number of hours to finish the task

estimated_effort_minutes

Estimated number of minutes to finish the task

estimated_effort

The estimated effort needed to finish the task

task_type

Used to categorize the tasks of similar cases

task_index
TASK_INDEX(Read-Only)

Order of the task

attachments

Files that are attached to the task. Maximum of 10 files can be attached to a task.

deleted
BOOLEAN(Read-Only)

Indicates whether the task is deleted or not

overdue
BOOLEAN(Read-Only)

Indicates whether the task is overdue or not

associated_entity
STRING(Read-Only)

Entity associated to the task

request
REQUEST(Read-Only)

Request Entity to which the task is going to be associated. The request information will be provided only if the task is associated to that request.

problem
PROBLEM(Read-Only)

Problem Entity to which the task is going to be associated. The problem information will be provided only if the task is associated to that problem.

change
CHANGE(Read-Only)

Change Entity to which the task is going to be associated. The change information will be provided only if the task is associated to that change.

project
PROJECT(Read-Only)

Project Entity to which the task is going to be associated. The project information will be provided only if the task is associated to that project.

milestone
MILESTONE(Read-Only)

Milestone Entity to which the task is going to be associated. The milestone information will be provided only if the task is associated to that milestone.

request_template
REQUEST_TEMPLATE(Read-Only)

The request template with which the task is associated. The request template information will be provided only if the task is associated to that request template.

project_template
PROJECT_TEMPLATE(Read-Only)

The project template with which the task is associated. The project template information will be provided only if the task is associated to that project template.

milestone_template

The milestone template with which the task is associated. The milestone template information will be provided only if the task is associated to that milestone template.

Add Request Task

POST /api/v3/requests/{request_id}/tasks

Request Example

$ curl /api/v3/requests/{request_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "percentage_completion": 13,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "name": "Lincoln",
      "id": "2283516941295988"
    },
    "priority": {
      "name": "High",
      "id": "1798252458435155"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort": "1505081186575103",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1994371102189359"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 13,
    "request": {
      "id": "2163094949046692"
    },
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1539416012908537",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2283516941295988",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1798252458435155"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1810767714399012",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "task_index": "test-task_index",
    "estimated_effort": "1505081186575103",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1994371102189359"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add request task.

Mandatory Fields :- <title>

Show All Attributes

Update Request Task

PUT /api/v3/requests/{request_id}/tasks/{task_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "owner": {
      "name": "Lincoln",
      "id": "1518142395260995"
    },
    "percentage_completion": 47,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "priority": {
      "name": "High",
      "id": "1577289705984145"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "estimated_effort": "1583078951256278",
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2245075096972942"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2151976926483335"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 47,
    "request": {
      "id": "234134234343234"
    },
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1888002207775724",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1518142395260995",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1577289705984145"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1675484647602727",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "estimated_effort": "1583078951256278",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2245075096972942"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "2151976926483335"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update request task.

Show All Attributes

Delete Request Task

DELETE /api/v3/requests/{request_id}/tasks/{task_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete request task.

Get Request Task

GET /api/v3/requests/{request_id}/tasks/{task_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "task": {
    "percentage_completion": 3,
    "request": {
      "id": "1574257016787386"
    },
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1558878407567499",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2109753351530765"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1626938947249970",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2238486936179914"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2184005405952290",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "2182652721824933"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "task_index": "test-task_index",
    "estimated_effort": "1827426711806803",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2301417840058760"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1816799214484140"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get request task.

Show All Attributes

Get All Request Tasks

GET /api/v3/requests/{request_id}/tasks

Request Example

$ curl /api/v3/requests/{request_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "tasks": [
    {
      "percentage_completion": 31,
      "request": {
        "id": "1746198704610476"
      },
      "estimated_effort_hours": "20",
      "email_before": "1536731560033",
      "description": "The SRS must contain all the requirements for the feature",
      "title": "Create SRS",
      "marked_technician": null,
      "overdue": false,
      "additional_cost": 1343434.4333,
      "actual_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "id": "1549954368102516",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "group": {
        "name": "Hardware Problems",
        "id": "1533115969950077"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1914123510880460",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "request",
      "module": "Request",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2124500291184411"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1574009973971958",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "marked_group": {
        "name": "Hardware Problems",
        "id": "1511749250089062"
      },
      "site": "Boston",
      "estimated_effort_minutes": "45",
      "deleted": false,
      "task_index": "test-task_index",
      "estimated_effort": "2116838724689723",
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1788157973579911"
      },
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "in_progress": false,
        "internal_name": "test-internal_name",
        "color": "#ffffff",
        "name": "Open",
        "id": "2312717518978743"
      }
    }
  ]
}

This operation helps you Get all request tasks.

Show All Attributes

Add Attachment To A Request Task

POST api/v3/requests/{request_id}/tasks/{task_id}/uploads
$ curl api/v3/requests/{request_id}/tasks/{task_id}/uploads \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -F "filename=@local_file_path" -F "addtoattachment=true"

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "files": [
    {
      "content_type": "application/zip",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
      "content_url": "/requests/3421234312443123/tasks/43234334341234564/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a request task. Here, the input must be given as multipart - form data.

Mandatory Fields :- <filename>

All Attributes
filename
The path of the file to be uploaded must be given with ’@’ at the beginning of the path
addtoattachment
Denotes whether to add the file as an attachment to the associated entity
The details of the file is contained here
size
The size of the file that is uploaded
content_type
The type of the content of the file
file_id
The file_id is used to add that file as an attachment to the entity
name
The name of the file
content_url
The url of the file that is uploaded

Worklog

Helps you track and capture the work done by a team member. 

All Attributes
id

Unique id of the Worklog

created_by
REFERRED_FIELD(Read-Only)

The user who created the worklog

owner

Owner for the worklog

description

Description about the worklog.

time_spent

The time spent in terms of hours, minutes and seconds.

start_time

Date and time to start the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

end_time

Date and time to end the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

recorded_time

Date and time of creation of Worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

other_charge

Extra charges other than the Technician related to the worklog.

total_charge
DOUBLE(Read-Only)

The total charges related to the worklog

tech_charge

The technician charges related to the worklog

worklog_type

Worklog type allows you to record the different modes of technician’s work

include_nonoperational_hours

Indicates whether to include non-operational hours or not.

mark_first_response

Indicates whether to set responded date of a Request/ticket while adding worklog for that request/ticket

Add Request Worklog

POST /api/v3/requests/{request_id}/worklogs

Request Example

$ curl /api/v3/requests/{request_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "1946058749273113"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1946058749273113",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1793178899276484",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    },
    "id": "1918317974982165"
  }
}

This operation helps you Add request worklog.

Mandatory Fields :- <owner>

Show All Attributes

Update Request Worklog

PUT /api/v3/requests/{request_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "2160865444733558"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "2465592427928450"
    },
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2160865444733558",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1586529444608760",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "2465592427928450"
    },
    "id": "2298986132904991"
  }
}

This operation helps you Update request worklog.

Show All Attributes

Delete Request Worklog

DELETE /api/v3/requests/{request_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete request worklog.

Get Request Worklog

GET /api/v3/requests/{request_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2422567747025257",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1530295860122057",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1513827184528037"
    },
    "id": "1489664120055605"
  }
}

This operation helps you Get request worklog.

Show All Attributes

Get All Request Worklogs

GET /api/v3/requests/{request_id}/worklogs

Request Example

$ curl /api/v3/requests/{request_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "worklogs": [
    {
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1499449454939099",
        "photo_url": "test-photo_url"
      },
      "include_nonoperational_hours": false,
      "end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "description": "test-description",
      "other_charge": "30.00",
      "total_charge": "45.00",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1511305530053086",
        "photo_url": "test-photo_url"
      },
      "recorded_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "tech_charge": "15.00",
      "time_spent": {
        "hours": 16800,
        "minutes": 54
      },
      "mark_first_response": false,
      "start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "worklog_type": {
        "name": "test-name",
        "id": "1591520121357298"
      },
      "id": "1750742406667404"
    }
  ]
}

This operation helps you Get all request worklogs.

Show All Attributes

Request Task - Worklog

Helps you track and capture the work done by a team member. 

Attributes

All Attributes
id

Unique id of the Worklog

created_by
REFERRED_FIELD(Read-Only)

The user who created the worklog

owner
Owner of the worklog
description

Description about the worklog.

time_spent

The time spent in terms of hours, minutes and seconds.

start_time

Date and time to start the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

end_time

Date and time to end the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

recorded_time

Date and time of creation of Worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

other_charge

Extra charges other than the Technician related to the worklog.

total_charge
DOUBLE(Read-Only)

The total charges related to the worklog

tech_charge

The technician charges related to the worklog

Add Worklog For Request Task

POST /api/v3/requests/{request_id}/tasks/{task_id}/worklogs

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "1946058749273113"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1946058749273113",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1793178899276484",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    },
    "id": "1918317974982165"
  }
}

This operation helps you Add worklog for request task.

Mandatory Fields :- <owner>

Show All Attributes

Update Worklog For Request Task

PUT /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "2160865444733558"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "2465592427928450"
    },
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2160865444733558",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1586529444608760",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "2465592427928450"
    },
    "id": "2298986132904991"
  }
}

This operation helps you Update worklog for request task.

Show All Attributes

Delete Worklog For Request Task

DELETE /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete worklog for request task.

Get Worklog For Request Task

GET /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2422567747025257",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1530295860122057",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1513827184528037"
    },
    "id": "1489664120055605"
  }
}

This operation helps you Get worklog for request task.

Show All Attributes

Get All Worklogs For Request Task

GET /api/v3/requests/{request_id}/tasks/{task_id}/worklogs

Request Example

$ curl /api/v3/requests/{request_id}/tasks/{task_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "worklogs": [
    {
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1499449454939099",
        "photo_url": "test-photo_url"
      },
      "include_nonoperational_hours": false,
      "end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "description": "test-description",
      "other_charge": "30.00",
      "total_charge": "45.00",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1511305530053086",
        "photo_url": "test-photo_url"
      },
      "recorded_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "tech_charge": "15.00",
      "time_spent": {
        "hours": 16800,
        "minutes": 54
      },
      "mark_first_response": false,
      "start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "worklog_type": {
        "name": "test-name",
        "id": "1591520121357298"
      },
      "id": "1750742406667404"
    }
  ]
}

This operation helps you Get all worklogs for request task.

Show All Attributes

Changes

Change management is a structured way of handling changes in goals, processes, or implemented technologies within an organization.

The goal of change management is to follow standardized methods and procedures to minimize the impact of change-related incidents on service quality and also to improve the everyday operations of the organization.



Change

Change requests are initiated to improve services and reduce costs incurred due to recurrent problems

All Attributes
id

The unique identifier assigned at creation

display_id
SEQUENCE_NUMBER(Read-Only)

Sequence number of the change request

title

Title of the change request

template

Change templates helps to create customized change template forms by defining its layout for the most frequently raised change. Thus the change can be created quickly with all the needed fields filled automatically.

emergency
BOOLEAN(Read-Only)

Indicates emergency change, if true, or normal change, if false

retrospective

Indicates whether the change is retrospective

change_requester

Initiator of the change request

change_manager

User who manages the entire life cycle of the change

description

Description of the change request

reason_for_change

Reasons why the change was initiated.

risk

Whether this involves high, low, or medium risk.

stage

Indicates the current stage of the change

status

Indicates the current status of the change

comment

Reason for status update. Whenever the user modifies the status, comment is mandatory.

approval_status
REFERRED_FIELD(Read-Only)

Lists approval statuses responsible for moving change from Pending Approval status to Approved/Rejected

impact

Describes how this change will affect the business, department, group, or user

priority

Indicates whether the change is high, low, or medium priority

category

Assign the Category of the CIs invloved to this change, such as routers, switches, software etc

subcategory

Assign the Sub Category of the involved CIs selected under Category

item

Assign the item belongs to the selected Category and Sub Category.

urgency

Indicates urgency of the change request

change_type

Indicates whether it is a minor, major, significant, or standard change

site

Indicates the site of the change request

group

The assigned group of the change request

change_owner

The owner of the change request

created_time

Indicates the creation time of the change request

completed_time

Indicates the completion time of the change request

services

The services that might be affected due  to this change

assets

Affected assets

scheduled_start_time

Indicates the scheduled start time of the change

scheduled_end_time

Indicates the scheduled time to complete the change

notes_present
BOOLEAN(Read-Only)

Indicates if the change contains any notes

roles

Roles are access permissions defined exclusively for the change module and differs for each and every change request. A Role when assigned to a user allows the user to perform tasks defined in the role for that change request alone. 

roll_out_plan

Describe how the change process will be implemented

roll_out_plan_description

Describes in detail the change process implementation

roll_out_plan_updated_on
DATETIME(Read-Only)

Indicates when the roll out plan was last updated

roll_out_plan_updated_by
REFERRED_FIELD(Read-Only)

User who last updated the roll out plan

back_out_plan

A Contingency plan to be implemented in case change technicians decide to back out of the change will be recorded/planned under the backout plan section

back_out_plan_description

Decribes in detail the mitigation plans if the change implementation were to be backed out

back_out_plan_updated_on
DATETIME(Read-Only)

Indicates when the back out plan was last updated

back_out_plan_updated_by
REFERRED_FIELD(Read-Only)

User who last updated the back out plan.

impact_details

Describes how the change process will affect the business

impact_details_description

Contains detailed information on how the change will affect the organization, including any expected any business loss or downtime

impact_details_updated_on
DATETIME(Read-Only)

Indicates when impact details was last updated

impact_details_updated_by
REFERRED_FIELD(Read-Only)

User who last updated the impact details

Lists the tasks involved in the change process

checklist_description

A to-do list listing the essential steps to be completed in order to verify whether the change implementation is completed with all requirements fullfilled.

checklist_updated_on
DATETIME(Read-Only)

Indicates the last time at which the checklist has been updated.

checklist_updated_by
REFERRED_FIELD(Read-Only)

The last user who updates checklist.

review_details

Contains the team’s evaluation of the entire life cycle of the initiated change

review_details_description

Contains review information of the change from submission through implementation

review_details_updated_on
DATETIME(Read-Only)

Indicates the last time the review has been updated on.

next_review_on

Indicates the scheduled date for next review.

review_details_updated_by
REFERRED_FIELD(Read-Only)

The last user who updates review details.

close_details

Contains information about change closure

close_details_description

Contains close description for the change.

close_details_updated_on
DATETIME(Read-Only)

Indicates the time at which close details has been updated on.

close_details_updated_by
REFERRED_FIELD(Read-Only)

The last user who updates close details.

closure_code

Closure Code denotes the reason for closing a change request.

workflow

Describes the change workflow, along with stagewise approvals

attachments

Files that are attached to the change. Maximum of 10 attachments can be attached to a change.

udf_fields

Contains user defined field values of the change

deleted_time
DATETIME(Read-Only)

Indicates when the change request was sent to trash

workflow_instance_details
REFERRED_FIELD(Read-Only)

Indicates the workflow execution status

Add Changes

POST /api/v3/changes

Request Example

$ curl /api/v3/changes \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "change": {
    "template": {
      "name": "test-name",
      "id": "2002921613087413"
    },
    "roles": [
      {
        "role": {
          "name": "Line Manager",
          "id": "1838125903088921"
        },
        "user": {
          "name": "Albert Cruze",
          "id": "1617125759969110"
        }
      }
    ],
    "description": "test-description",
    "change_type": {
      "name": "test-name",
      "id": "2088982910161515"
    },
    "title": "test-title",
    "change_owner": {
      "name": "Einstein",
      "id": "2319629534866900"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2093300009168953"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "1540592381858643"
    },
    "change_requester": {
      "name": "Lincoln",
      "id": "1991377176632535"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1995346989151162"
    },
    "item": {
      "name": "Install",
      "id": "1970142052272725"
    },
    "workflow": {
      "name": "test-name",
      "id": "1784324187325470"
    },
    "change_manager": {
      "name": "Einstein",
      "id": "1707640943962635"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2297706380000182"
    },
    "retrospective": false,
    "services": [
      {
        "name": "Corporate Website",
        "id": "2174900905772298"
      }
    ],
    "priority": {
      "name": "High",
      "id": "1741491912033834"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2437494495076651"
    },
    "reason_for_change": {
      "name": "test-name",
      "id": "2139182810170635"
    },
    "stage": {
      "name": "Submission",
      "id": "67928372908"
    },
    "udf_fields": {
      "udf_long1": "2159165086323240",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "comment": "test-comment",
    "risk": {
      "name": "test-name",
      "id": "2292425698675599"
    },
    "category": {
      "name": "Software",
      "id": "2202888544455135"
    },
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2352186455953527"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Requested",
      "id": "1692833054639436"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change": {
    "template": {
      "name": "test-name",
      "id": "2002921613087413"
    },
    "attachments": [],
    "roll_out_plan": {
      "roll_out_plan_updated_on": null,
      "roll_out_plan_updated_by": null,
      "roll_out_plan_description": null
    },
    "display_id": {
      "display_value": "CH 44",
      "value": "44"
    },
    "roles": [
      {
        "role": {
          "internal_name": "line_manager",
          "user_type": "TECH",
          "name": "Line Manager",
          "id": "1838125903088921"
        },
        "user": {
          "email_id": "albertcruze@zinmail.com",
          "sms_mail": "test-sms_mail",
          "phone": "32323413431",
          "name": "Albert Cruze",
          "id": "1617125759969110",
          "photo_url": "test-photo_url"
        }
      }
    ],
    "emergency": false,
    "description": "test-description",
    "change_type": {
      "color": "#ffffff",
      "pre_approved": false,
      "name": "test-name",
      "id": "2088982910161515"
    },
    "title": "test-title",
    "review_details": {
      "review_details_updated_by": null,
      "next_review_on": null,
      "review_details_updated_on": null,
      "review_details_description": null
    },
    "change_owner": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "2319629534866900"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2093300009168953"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "1540592381858643"
    },
    "workflow_instance_details": {
      "id": "1898695757785182",
      "status": {
        "name": "In Progress",
        "id": "3452123479302930"
      }
    },
    "close_details": {
      "close_details_updated_on": null,
      "close_details_description": null,
      "closure_code": null,
      "close_details_updated_by": null
    },
    "id": "2231181940397481",
    "change_requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1991377176632535",
      "photo_url": "test-photo_url"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1995346989151162"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1970142052272725"
    },
    "workflow": {
      "validated": false,
      "name": "test-name",
      "id": "1784324187325470"
    },
    "approval_status": {
      "name": "test-name",
      "id": "2337910135940853"
    },
    "change_manager": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "1707640943962635"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2297706380000182"
    },
    "retrospective": false,
    "checklist": {
      "checklist_description": null,
      "checklist_updated_on": null,
      "checklist_updated_by": null
    },
    "services": [
      {
        "name": "Corporate Website",
        "id": "2174900905772298"
      }
    ],
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1741491912033834"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "back_out_plan": {
      "back_out_plan_updated_by": null,
      "back_out_plan_updated_on": null,
      "back_out_plan_description": null
    },
    "site": {
      "name": "Custom Site",
      "id": "2437494495076651"
    },
    "completed_time": null,
    "reason_for_change": {
      "name": "test-name",
      "id": "2139182810170635"
    },
    "stage": {
      "internal_name": "submission",
      "stage_index": 24,
      "name": "Submission",
      "id": "67928372908"
    },
    "udf_fields": {
      "udf_long1": "2159165086323240",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "comment": "test-comment",
    "impact_details": {
      "impact_details_updated_on": null,
      "impact_details_updated_by": null,
      "impact_details_description": null
    },
    "risk": {
      "name": "test-name",
      "id": "2292425698675599"
    },
    "category": {
      "name": "Software",
      "id": "2202888544455135"
    },
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2352186455953527"
    },
    "deleted_time": null,
    "notes_present": false,
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "requested",
      "stage": {
        "id": "67928372908"
      },
      "name": "Requested",
      "id": "1692833054639436"
    }
  }
}

This operation helps you Add changes.

Mandatory Fields :- <title>,<stage>,<status>

Show All Attributes

Edit Changes

PUT /api/v3/changes/{change_id}

Request Example

$ curl /api/v3/changes/{change_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "change": {
    "template": {
      "name": "test-name",
      "id": "2138580568185976"
    },
    "roll_out_plan": {
      "roll_out_plan_description": "test-description"
    },
    "roles": [
      {
        "role": {
          "name": "Line Manager",
          "id": "2140898925623580"
        },
        "user": {
          "name": "Albert Cruze",
          "id": "1846465901534794"
        }
      }
    ],
    "description": "test-description",
    "change_type": {
      "name": "test-name",
      "id": "1544714873289678"
    },
    "title": "test-title",
    "review_details": {
      "review_details_description": "test-description"
    },
    "change_owner": {
      "name": "Einstein",
      "id": "2251859650138320"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2176172936632316"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "1484192879611824"
    },
    "close_details": {
      "close_details_description": "test-description"
    },
    "change_requester": {
      "name": "Lincoln",
      "id": "2352187091430909"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1523767199125247"
    },
    "created_time": {
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1530346230586469"
    },
    "workflow": {
      "name": "test-name",
      "id": "2203010276181508"
    },
    "change_manager": {
      "name": "Einstein",
      "id": "2417626526613138"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1649386517579004"
    },
    "retrospective": false,
    "checklist": {
      "checklist_description": "test-description"
    },
    "services": [
      {
        "name": "Corporate Website",
        "id": "2269018141598035"
      }
    ],
    "priority": {
      "name": "High",
      "id": "1698767541917612"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "back_out_plan": {
      "back_out_plan_description": "test-description"
    },
    "site": {
      "name": "Custom Site",
      "id": "2472862103435687"
    },
    "reason_for_change": {
      "name": "test-name",
      "id": "1501971905691861"
    },
    "stage": {
      "name": "Submission",
      "id": "67928372908"
    },
    "udf_fields": {
      "udf_long1": "2110626065738486",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "comment": "test-comment",
    "impact_details": {
      "impact_details_description": "test-description"
    },
    "risk": {
      "name": "test-name",
      "id": "2118989848204827"
    },
    "category": {
      "name": "Software",
      "id": "2320506907871930"
    },
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1711208575366600"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Requested",
      "id": "2433776778216871"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change": {
    "template": {
      "name": "test-name",
      "id": "2138580568185976"
    },
    "attachments": [],
    "roll_out_plan": {
      "roll_out_plan_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "roll_out_plan_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      },
      "roll_out_plan_description": "test-description"
    },
    "display_id": {
      "display_value": "CH 44",
      "value": "44"
    },
    "roles": [
      {
        "role": {
          "internal_name": "line_manager",
          "user_type": "TECH",
          "name": "Line Manager",
          "id": "2140898925623580"
        },
        "user": {
          "email_id": "albertcruze@zinmail.com",
          "sms_mail": "test-sms_mail",
          "phone": "32323413431",
          "name": "Albert Cruze",
          "id": "1846465901534794",
          "photo_url": "test-photo_url"
        }
      }
    ],
    "emergency": false,
    "description": "test-description",
    "change_type": {
      "color": "#ffffff",
      "pre_approved": false,
      "name": "test-name",
      "id": "1544714873289678"
    },
    "title": "test-title",
    "review_details": {
      "review_details_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      },
      "next_review_on": null,
      "review_details_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "review_details_description": "test-description"
    },
    "change_owner": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "2251859650138320"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2176172936632316"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "1484192879611824"
    },
    "workflow_instance_details": {
      "id": "1913062915446629",
      "status": {
        "name": "In Progress",
        "id": "3452123479302930"
      }
    },
    "close_details": {
      "close_details_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "close_details_description": "test-description",
      "closure_code": null,
      "close_details_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      }
    },
    "id": "2477610208469593",
    "change_requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2352187091430909",
      "photo_url": "test-photo_url"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1523767199125247"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1530346230586469"
    },
    "workflow": {
      "validated": false,
      "name": "test-name",
      "id": "2203010276181508"
    },
    "approval_status": {
      "name": "test-name",
      "id": "1666154283544011"
    },
    "change_manager": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "2417626526613138"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1649386517579004"
    },
    "retrospective": false,
    "checklist": {
      "checklist_description": "test-description",
      "checklist_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "checklist_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      }
    },
    "services": [
      {
        "name": "Corporate Website",
        "id": "2269018141598035"
      }
    ],
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1698767541917612"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "back_out_plan": {
      "back_out_plan_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      },
      "back_out_plan_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "back_out_plan_description": "test-description"
    },
    "site": {
      "name": "Custom Site",
      "id": "2472862103435687"
    },
    "completed_time": null,
    "reason_for_change": {
      "name": "test-name",
      "id": "1501971905691861"
    },
    "stage": {
      "internal_name": "submission",
      "stage_index": 14,
      "name": "Submission",
      "id": "67928372908"
    },
    "udf_fields": {
      "udf_long1": "2110626065738486",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "comment": "test-comment",
    "impact_details": {
      "roll_out_plan_updated_on": {
        "display_value": "Oct 10, 2018 02:41 PM",
        "value": "1539162689719"
      },
      "impact_details_updated_on": null,
      "roll_out_plan_updated_by": {
        "email_id": "albertd@zinmail.com",
        "sms_mail": "test-sms_mail",
        "phone": "98764342344",
        "name": "Albert",
        "id": "1633000000074011",
        "photo_url": "test-photo_url",
        "department": null
      },
      "impact_details_updated_by": null,
      "impact_details_description": "test-description"
    },
    "risk": {
      "name": "test-name",
      "id": "2118989848204827"
    },
    "category": {
      "name": "Software",
      "id": "2320506907871930"
    },
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1711208575366600"
    },
    "deleted_time": null,
    "notes_present": false,
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "requested",
      "stage": {
        "id": "67928372908"
      },
      "name": "Requested",
      "id": "2433776778216871"
    }
  }
}

This operation helps you Edit changes.

Show All Attributes

Delete Changes

DELETE /api/v3/changes/{change_id}

Request Example

$ curl /api/v3/changes/{change_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete changes.

Get Changes

GET /api/v3/changes/{change_id}

Request Example

$ curl /api/v3/changes/{change_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change": {
    "template": {
      "name": "test-name",
      "id": "1522233156333684"
    },
    "attachments": [],
    "roll_out_plan": {
      "roll_out_plan_updated_on": null,
      "roll_out_plan_updated_by": null,
      "roll_out_plan_description": null
    },
    "display_id": {
      "display_value": "CH 44",
      "value": "44"
    },
    "roles": [
      {
        "role": {
          "internal_name": "line_manager",
          "user_type": "TECH",
          "name": "Line Manager",
          "id": "1555648020806407"
        },
        "user": {
          "email_id": "albertcruze@zinmail.com",
          "sms_mail": "test-sms_mail",
          "phone": "32323413431",
          "name": "Albert Cruze",
          "id": "1672646524687744",
          "photo_url": "test-photo_url"
        }
      }
    ],
    "emergency": false,
    "description": "test-description",
    "change_type": {
      "color": "#ffffff",
      "pre_approved": false,
      "name": "test-name",
      "id": "1801268000981701"
    },
    "title": "test-title",
    "review_details": {
      "review_details_updated_by": null,
      "next_review_on": null,
      "review_details_updated_on": null,
      "review_details_description": null
    },
    "change_owner": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "2376874851698164"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2003214859466619"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "2292846447877806"
    },
    "workflow_instance_details": {
      "id": "2081590344609845",
      "status": {
        "name": "In Progress",
        "id": "3452123479302930"
      }
    },
    "close_details": {
      "close_details_updated_on": null,
      "close_details_description": null,
      "closure_code": null,
      "close_details_updated_by": null
    },
    "id": "2345283475858656",
    "change_requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2033617111612701",
      "photo_url": "test-photo_url"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2294711380034890"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "2320076614016211"
    },
    "workflow": {
      "validated": false,
      "name": "test-name",
      "id": "1786299946213690"
    },
    "approval_status": {
      "name": "test-name",
      "id": "1485528951478328"
    },
    "change_manager": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Einstein",
      "id": "2183606827613580"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1683203940067821"
    },
    "retrospective": false,
    "checklist": {
      "checklist_description": null,
      "checklist_updated_on": null,
      "checklist_updated_by": null
    },
    "services": [
      {
        "name": "Corporate Website",
        "id": "1708489761624563"
      }
    ],
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2139615519423667"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "back_out_plan": {
      "back_out_plan_updated_by": null,
      "back_out_plan_updated_on": null,
      "back_out_plan_description": null
    },
    "site": {
      "name": "Custom Site",
      "id": "2132250645333716"
    },
    "completed_time": null,
    "reason_for_change": {
      "name": "test-name",
      "id": "1740957890336470"
    },
    "stage": {
      "internal_name": "submission",
      "stage_index": 12,
      "name": "Submission",
      "id": "67928372908"
    },
    "udf_fields": {
      "udf_long1": "2476888037810172",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "comment": "test-comment",
    "impact_details": {
      "impact_details_updated_on": null,
      "impact_details_updated_by": null,
      "impact_details_description": null
    },
    "risk": {
      "name": "test-name",
      "id": "1698733651869300"
    },
    "category": {
      "name": "Software",
      "id": "2266695353174976"
    },
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2276873281300034"
    },
    "deleted_time": null,
    "notes_present": false,
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "requested",
      "stage": {
        "id": "67928372908"
      },
      "name": "Requested",
      "id": "2317929591524491"
    }
  }
}

This operation helps you Get changes.

Show All Attributes

Get List Changes

GET /api/v3/changes

Request Example

$ curl /api/v3/changes \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "changes": [
    {
      "template": {
        "name": "test-name",
        "id": "2072838636827383"
      },
      "display_id": {
        "display_value": "CH 44",
        "value": "44"
      },
      "emergency": false,
      "description": "test-description",
      "change_type": {
        "color": "#ffffff",
        "pre_approved": false,
        "name": "test-name",
        "id": "2031790959301656"
      },
      "title": "test-title",
      "change_owner": {
        "email_id": "test@test.com",
        "cost_per_hour": 1343434.4333,
        "name": "Einstein",
        "id": "1914864456528322"
      },
      "urgency": {
        "name": "Urgent",
        "id": "2001505768231383"
      },
      "workflow_instance_details": {
        "id": "2041163798114927",
        "status": {
          "name": "In Progress",
          "id": "3452123479302930"
        }
      },
      "id": "1863684702840887",
      "change_requester": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2120557485747513",
        "photo_url": "test-photo_url"
      },
      "group": {
        "name": "Hardware Problems",
        "id": "1579327417648400"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "item": {
        "name": "Install",
        "id": "1635478882039719"
      },
      "workflow": {
        "validated": false,
        "name": "test-name",
        "id": "1769041292983786"
      },
      "approval_status": {
        "name": "test-name",
        "id": "1989129581885047"
      },
      "change_manager": {
        "email_id": "test@test.com",
        "cost_per_hour": 1343434.4333,
        "name": "Einstein",
        "id": "1891759779470416"
      },
      "impact": {
        "name": "Affects Business",
        "id": "1985554514232746"
      },
      "retrospective": false,
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "1860496928975987"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "site": {
        "name": "Custom Site",
        "id": "2099643495855731"
      },
      "completed_time": null,
      "reason_for_change": {
        "name": "test-name",
        "id": "1657721020574673"
      },
      "stage": {
        "internal_name": "submission",
        "stage_index": 17,
        "name": "Submission",
        "id": "67928372908"
      },
      "udf_fields": {
        "udf_long1": "1527249315956124",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_char1": "test-udf_char1"
      },
      "comment": "test-comment",
      "risk": {
        "name": "test-name",
        "id": "1920634983167451"
      },
      "category": {
        "name": "Software",
        "id": "2028796063811306"
      },
      "subcategory": {
        "name": "Adobe Reader",
        "id": "2027562263899380"
      },
      "deleted_time": null,
      "notes_present": false,
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "internal_name": "requested",
        "stage": {
          "id": "67928372908"
        },
        "name": "Requested",
        "id": "1544018304037859"
      }
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get list changes.

Show All Attributes

Approval Level

Multi level approval process of Change module requires that the change request be approved by levels of approvers. Approvers whom the application administrator has configured as Level 1 approvers will review the change request first. After they have provided their signatures and thereby given approval, the approvers on Level 2 are notified and must review the change request. If an approver rejects a change request, the approval process is finished.

Add Change Approval Level

POST /api/v3/changes/{change_id}/approval_levels

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval_level": {
    "change_stage": {
      "internal_name": "cab_evaluation"
    },
    "level": "1",
    "rule": {
      "name": "sdp.approval.everyone_approves"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval_level": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "change_stage": {
      "internal_name": "cab_evaluation",
      "stage_index": 41,
      "name": "Cab Evaluation\t",
      "id": "67928372908"
    },
    "level": "1",
    "associated_entity": "change",
    "change": {
      "display_id": {
        "display_value": "CH 44",
        "value": "44"
      },
      "id": "2336250724018565",
      "title": "test-title"
    },
    "rule": {
      "name": "sdp.approval.everyone_approves",
      "id": "2265490414408594",
      "type": "everyone_approves",
      "value": "1478758440000"
    },
    "id": "1842194762413385",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1578000382843765",
      "photo_url": "test-photo_url"
    },
    "status": {
      "name": "To be Sent",
      "id": "2476922526199106"
    }
  }
}

This operation helps you Add change approval level.

Show All Attributes

Delete Change Approval Level

DELETE /api/v3/changes/{change_id}/approval_levels/{approval_level_id}

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete change approval level.

Get Change Approval Level

GET /api/v3/changes/{change_id}/approval_levels/{approval_level_id}

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval_level": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "change_stage": {
      "internal_name": "cab_evaluation",
      "stage_index": 48,
      "name": "Cab Evaluation\t",
      "id": "67928372908"
    },
    "level": "1",
    "associated_entity": "change",
    "change": {
      "display_id": {
        "display_value": "CH 44",
        "value": "44"
      },
      "id": "1898866781711886",
      "title": "test-title"
    },
    "rule": {
      "name": "sdp.approval.everyone_approves",
      "id": "2228626584936497",
      "type": "everyone_approves",
      "value": "1478758440000"
    },
    "id": "2407159533889406",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2157582954161921",
      "photo_url": "test-photo_url"
    },
    "status": {
      "name": "To be Sent",
      "id": "1789397884257791"
    }
  }
}

This operation helps you Get change approval level.

Show All Attributes

Get All Change Approval Levels

GET /api/v3/changes/{change_id}/approval_levels

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "approval_levels": [
    {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "change_stage": {
        "internal_name": "cab_evaluation",
        "stage_index": 7,
        "name": "Cab Evaluation\t",
        "id": "67928372908"
      },
      "level": "1",
      "associated_entity": "change",
      "change": {
        "display_id": {
          "display_value": "CH 44",
          "value": "44"
        },
        "id": "2128352440902323",
        "title": "test-title"
      },
      "rule": {
        "name": "sdp.approval.everyone_approves",
        "id": "1822104139188929",
        "type": "everyone_approves",
        "value": "1478758440000"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1750944246824302",
        "photo_url": "test-photo_url"
      },
      "id": "1734103992877705",
      "status": {
        "name": "To be Sent",
        "id": "2287817200475058"
      }
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all change approval levels.

Show All Attributes

Approval

Change requests must be approved by the stakeholders who are impacted when the change is implemented. Change requests go through a series of approval states, and approvers and update its approval status based on the approval rule set by the administrators.

Add Change Approval

POST /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "approver": {
      "name": "Lincoln",
      "id": "2259331570419529"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval": {
    "approver": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2259331570419529",
      "photo_url": "test-photo_url"
    },
    "xpath": null,
    "comments": "Comments for why this entity is approved/rejected",
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "level": "1",
      "associated_entity": "change",
      "change": {
        "id": "573363737610000"
      },
      "id": "1582279109690945",
      "created_by": {
        "id": "163363737611449"
      },
      "status": {
        "id": "573363737611449"
      }
    },
    "id": "2194773872625690",
    "sent_on": null,
    "action_taken_on": null,
    "status": {
      "name": "To be Sent",
      "id": "1828323165014223"
    }
  }
}

This operation helps you Add change approval.

Show All Attributes

Delete Change Approval

DELETE /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete change approval.

Get Change Approval

GET /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "approval": {
    "approver": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2211378041392294",
      "photo_url": "test-photo_url"
    },
    "xpath": null,
    "comments": "Comments for why this entity is approved/rejected",
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "level": "1",
      "associated_entity": "change",
      "change": {
        "id": "573363737610000"
      },
      "id": "1886574551696383",
      "created_by": {
        "id": "163363737611449"
      },
      "status": {
        "id": "573363737611449"
      }
    },
    "id": "1814871839560603",
    "sent_on": null,
    "action_taken_on": null,
    "status": {
      "name": "To be Sent",
      "id": "1811279054491740"
    }
  }
}

This operation helps you Get change approval.

Show All Attributes

Get All Change Approvals

GET /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "approvals": [
    {
      "approver": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1864266719789711",
        "photo_url": "test-photo_url"
      },
      "xpath": null,
      "comments": "Comments for why this entity is approved/rejected",
      "approval_level": {
        "created_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "level": "1",
        "associated_entity": "change",
        "change": {
          "id": "573363737610000"
        },
        "id": "2061748410102907",
        "created_by": {
          "id": "163363737611449"
        },
        "status": {
          "id": "573363737611449"
        }
      },
      "id": "2004511605005677",
      "sent_on": null,
      "action_taken_on": null,
      "status": {
        "name": "To be Sent",
        "id": "1985084151506791"
      }
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all change approvals.

Show All Attributes

Approve Change Approval

PUT /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/approve

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/approve \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "comments": "The comments to approve the approval"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Your decision has been recorded. Thank you for your cooperation!"
      }
    ],
    "status": "success"
  }
}

This operation helps you Approve change approval.

Show All Attributes

Reject Change Approval

PUT /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/reject

Request Example

$ curl /api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/reject \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "approval": {
    "comments": "The comments to reject the approval"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Your decision has been recorded. Thank you for your cooperation!"
      }
    ],
    "status": "success"
  }
}

This operation helps you Reject change approval.

Show All Attributes

Get Notification Content For Sending Change Approval

GET api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification

Request Example

$ curl api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "notification": {
    "subject": "Recommendation required for a Change",
    "description": "${submitter} has requested your recommendations for this Change - ${title}. Click here to view Change details ${approval_link}"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get notification content for sending change approval.

Show All Attributes

Send Notification For Change Approval

PUT api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification

Request Example

$ curl api/v3/changes/{change_id}/approval_levels/{approval_level_id}/approvals/{approval_id}/send_notification \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "messages": [
      {
        "status_code": 2000,
        "type": "success",
        "message": "Approval Mail Sent "
      }
    ],
    "status": "success"
  }
}

This operation helps you Send notification for change approval.

Show All Attributes

Task

A task is an activity or piece of work which you have to do, usually as part of a larger request/change/project/milestone/problem.

All Attributes
id

Unique Identifier to identify the task

title

Title of the task

description

Contains description about the task

module
STRING(Read-Only)

The module to which the task belongs to

created_date
DATETIME(Read-Only)

Date and time at which the task is created

scheduled_start_time

Date and time at which the task is scheduled to start

scheduled_end_time

Date and time at which the task is scheduled to finish

actual_start_time

Date and time at which the task has actually started

actual_end_time

Date and time at which the task actually got finished

status

Indicates the level of progress of the task

group

The group associated to the task

marked_group

The group to be assigned when the task is triggered

email_before

Indicates when to send an notification before schedule start

owner

The User assigned to the task

marked_technician

The user to be assigned when the task is triggered

created_by
REFERRED_FIELD(Read-Only)

Name and Id of the user who created the task is present in JSON format

priority

Defines the intensity or importance of a task. 

site
SITE(Read-Only)

The site to which the parent entity is associated

percentage_completion

Indicates the progress of the task in percentage of completion

additional_cost

Cost spent other than the actual cost of the task

estimated_effort_days

Estimated number of days to finish the task

estimated_effort_hours

Estimated number of hours to finish the task

estimated_effort_minutes

Estimated number of minutes to finish the task

estimated_effort

The estimated effort needed to finish the task

task_type

Used to categorize the tasks of similar cases

task_index
TASK_INDEX(Read-Only)

Order of the task

attachments

Files that are attached to the task. Maximum of 10 files can be attached to a task.

deleted
BOOLEAN(Read-Only)

Indicates whether the task is deleted or not

overdue
BOOLEAN(Read-Only)

Indicates whether the task is overdue or not

associated_entity
STRING(Read-Only)

Entity associated to the task

request
REQUEST(Read-Only)

Request Entity to which the task is going to be associated. The request information will be provided only if the task is associated to that request.

problem
PROBLEM(Read-Only)

Problem Entity to which the task is going to be associated. The problem information will be provided only if the task is associated to that problem.

change
CHANGE(Read-Only)

Change Entity to which the task is going to be associated. The change information will be provided only if the task is associated to that change.

project
PROJECT(Read-Only)

Project Entity to which the task is going to be associated. The project information will be provided only if the task is associated to that project.

milestone
MILESTONE(Read-Only)

Milestone Entity to which the task is going to be associated. The milestone information will be provided only if the task is associated to that milestone.

request_template
REQUEST_TEMPLATE(Read-Only)

The request template with which the task is associated. The request template information will be provided only if the task is associated to that request template.

project_template
PROJECT_TEMPLATE(Read-Only)

The project template with which the task is associated. The project template information will be provided only if the task is associated to that project template.

milestone_template

The milestone template with which the task is associated. The milestone template information will be provided only if the task is associated to that milestone template.

Add Change Task

POST /api/v3/changes/{change_id}/tasks

Request Example

$ curl /api/v3/changes/{change_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "percentage_completion": 13,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "name": "Lincoln",
      "id": "2283516941295988"
    },
    "priority": {
      "name": "High",
      "id": "1798252458435155"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort": "1505081186575103",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1994371102189359"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 13,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1539416012908537",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2283516941295988",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "change",
    "module": "Change",
    "change": {
      "id": "1826262066361404"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1798252458435155"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1810767714399012",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "task_index": "test-task_index",
    "estimated_effort": "1505081186575103",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1994371102189359"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add change task.

Mandatory Fields :- <title>

Show All Attributes

Update Change Task

PUT /api/v3/changes/{change_id}/tasks/{task_id}

Request Example

$ curl /api/v3/changes/{change_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "owner": {
      "name": "Lincoln",
      "id": "1518142395260995"
    },
    "percentage_completion": 47,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "priority": {
      "name": "High",
      "id": "1577289705984145"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "estimated_effort": "1583078951256278",
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2245075096972942"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2151976926483335"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 47,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1888002207775724",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1518142395260995",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "change",
    "module": "Change",
    "change": {
      "id": "234134234343234"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1577289705984145"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1675484647602727",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "estimated_effort": "1583078951256278",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2245075096972942"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "2151976926483335"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update change task.

Show All Attributes

Delete Change Task

DELETE /api/v3/changes/{change_id}/tasks/{task_id}

Request Example

$ curl /api/v3/changes/{change_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete change task.

Get Change Task

GET /api/v3/changes/{change_id}/tasks/{task_id}

Request Example

$ curl /api/v3/changes/{change_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "task": {
    "percentage_completion": 3,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1558878407567499",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2109753351530765"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1626938947249970",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "change",
    "module": "Change",
    "change": {
      "id": "1599481818135773"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2238486936179914"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2184005405952290",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "2182652721824933"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "task_index": "test-task_index",
    "estimated_effort": "1827426711806803",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2301417840058760"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1816799214484140"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get change task.

Show All Attributes

Get All Change Tasks

GET /api/v3/changes/{change_id}/tasks

Request Example

$ curl /api/v3/changes/{change_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "tasks": [
    {
      "percentage_completion": 31,
      "estimated_effort_hours": "20",
      "email_before": "1536731560033",
      "description": "The SRS must contain all the requirements for the feature",
      "title": "Create SRS",
      "marked_technician": null,
      "overdue": false,
      "additional_cost": 1343434.4333,
      "actual_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "id": "1549954368102516",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "group": {
        "name": "Hardware Problems",
        "id": "1533115969950077"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1914123510880460",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "change",
      "module": "Change",
      "change": {
        "id": "1753154734085861"
      },
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2124500291184411"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1574009973971958",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "marked_group": {
        "name": "Hardware Problems",
        "id": "1511749250089062"
      },
      "site": "Boston",
      "estimated_effort_minutes": "45",
      "deleted": false,
      "task_index": "test-task_index",
      "estimated_effort": "2116838724689723",
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1788157973579911"
      },
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "in_progress": false,
        "internal_name": "test-internal_name",
        "color": "#ffffff",
        "name": "Open",
        "id": "2312717518978743"
      }
    }
  ]
}

This operation helps you Get all change tasks.

Show All Attributes

Projects

Project management - the discipline of planning, organizing, and controlling resources to achieve specific goals is now a part of ServiceDesk Plus. Using project management you can create projects: a temporary endeavor to achieve certain objective/change (within a specific time period) beneficial to your organization.



Project

A temporary endeavor to achieve certain objective/change (within a specific time period) beneficial to the organization.Primary goal of the project management lies in effective management of resources like time, budget, manpower and the quality of work.

All Attributes
id

Unique identifier of the project

project_code

Unique code of the project

title

Title of the project

project_type

Type of the project

owner

User to which the project is assigned

priority

Priority/Importance of the project

status

Status of the project

project_template

The template with which the project is created

created_by
REFERRED_FIELD(Read-Only)

This attribute holds the user who created the project This attribute is applicable only for output and will be ignored in input fields

created_time
DATETIME(Read-Only)

Denotes the created time of the project 

scheduled_start_time

Denotes the planned starting time of the project 

scheduled_end_time

Denotes the planned ending time of the project

actual_start_time

Denotes the actual starting time of the project

actual_end_time

Denotes the actual ending time of the project

projected_end

The estimated end date for the project

estimated_hours

Denotes the hours estimated to complete the project

actual_hours

Denotes the actual hours taken to complete the project

estimated_cost

Denotes the cost estimated to complete the project

actual_cost

Denotes the actual cost spent to complete the project

percentage_completion

The percentage upto which the project has been completed

site

Site to which the project belongs

description

Description of the project

attachments

Attachments present in the milestone

udf_fields

The additional fields for the project

Add Project

POST /api/v3/projects

Request Example

$ curl /api/v3/projects \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project": {
    "owner": {
      "name": "Lincoln",
      "id": "1492591341204180"
    },
    "project_template": {
      "name": "Default",
      "id": "1634275609774472"
    },
    "percentage_completion": 47,
    "project_type": {
      "name": "Business",
      "id": "1649187298434983"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "2296745240283894"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2119346617233164"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_long1": "2010829560658705",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1837041233927773"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1492591341204180",
      "photo_url": "test-photo_url"
    },
    "project_template": {
      "name": "Default",
      "id": "1634275609774472",
      "title": "test-title"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 47,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "1649187298434983"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2296745240283894"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2386803171898446",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2119346617233164"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_long1": "2010829560658705",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "id": "1837964428314484",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "projected_end": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "1837041233927773"
    }
  }
}

This operation helps you Add project.

Mandatory Fields :- <title>

Show All Attributes

Update Project

PUT /api/v3/projects/{project_id}

Request Example

$ curl /api/v3/projects/{project_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project": {
    "owner": {
      "name": "Lincoln",
      "id": "2343771602307515"
    },
    "percentage_completion": 29,
    "project_type": {
      "name": "Business",
      "id": "2028928824048628"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "1593372262642065"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1533484625860549"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_long1": "1984045999513209",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1823211251708854"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2343771602307515",
      "photo_url": "test-photo_url"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 29,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "2028928824048628"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1593372262642065"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1786696080038347",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1533484625860549"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_long1": "1984045999513209",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "id": "1485217404899669",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "projected_end": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "1823211251708854"
    }
  }
}

This operation helps you Update project.

Show All Attributes

Delete Project

DELETE /api/v3/projects/{project_id}

Request Example

$ curl /api/v3/projects/{project_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete project.

Get Project

GET /api/v3/projects/{project_id}

Request Example

$ curl /api/v3/projects/{project_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2437215430472691",
      "photo_url": "test-photo_url"
    },
    "project_template": {
      "name": "Default",
      "id": "1534204937111432",
      "title": "test-title"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 49,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "1527799321288027"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2454337589668244"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1869718928188821",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1704988394213293"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_long1": "1827311492260705",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
    "id": "1844528656482884",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "projected_end": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "1555408580511084"
    }
  }
}

This operation helps you Get project.

Show All Attributes

Get All Projects

GET /api/v3/projects

Request Example

$ curl /api/v3/projects \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "projects": [
    {
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1585041597190831",
        "photo_url": "test-photo_url"
      },
      "project_template": {
        "name": "Default",
        "id": "2456782789519748",
        "title": "test-title"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "percentage_completion": 4,
      "project_type": {
        "color": "#ffffff",
        "name": "Business",
        "id": "2000975923770653"
      },
      "description": "test-description",
      "project_code": "test-project_code",
      "title": "test-title",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "1534959092148243"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2396988837182989",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "site": {
        "name": "Custom Site",
        "id": "2308925635538812"
      },
      "actual_hours": "15",
      "actual_cost": 1343434.4333,
      "estimated_cost": 1343434.4333,
      "actual_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "estimated_hours": "18",
      "udf_fields": {
        "udf_long1": "2014119105008415",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_char1": "test-udf_char1"
      },
      "id": "2274263142297388",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "projected_end": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "internal_name": "Open",
        "color": "#ffffff",
        "name": "Open",
        "id": "2042552173128040"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all projects.

Show All Attributes

Add Attachment To A Project

POST api/v3/projects/{project_id}/uploads
$ curl api/v3/projects/{project_id}/uploads \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -F "filename=@local_file_path" -F "addtoattachment=true"

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "files": [
    {
      "content_type": "application/zip",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
      "content_url": "/projects/4123312432431431/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a project. Here, the input must be given as multipart - form data.

Mandatory Fields :- <filename>

All Attributes
filename
The path of the file to be uploaded must be given with ’@’ at the beginning of the path
addtoattachment
Denotes whether to add the file as an attachment to the associated entity
The details of the file is contained here
size
The size of the file that is uploaded
content_type
The type of the content of the file
file_id
The file_id is used to add that file as an attachment to the entity
name
The name of the file
content_url
The url of the file that is uploaded

Attach Requests

POST api/v3/projects/{project_id}/request_associations
$ curl api/v3/projects/{project_id}/request_associations \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      {
  "requests": [
    "100000000000027125"
  ]
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you to Attach requests. Here, the input must be given as multipart - form data.

Detach Requests

DELETE api/v3/projects/{project_id}/request_associations

Request Example

$ curl api/v3/projects/{project_id}/request_associations \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "requests": [
    "100000000000027125"
  ]
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Detach requests.

Attach Changes

POST api/v3/projects/{project_id}/change_associations

Request Example

$ curl api/v3/projects/{project_id}/change_associations \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "changes": [
    "100000000000027125"
  ]
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Attach changes.

Show All Attributes

Detach Changes

DELETE api/v3/projects/{project_id}/change_associations

Request Example

$ curl api/v3/projects/{project_id}/change_associations \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "changes": [
    "100000000000027125"
  ]
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Detach changes.

Get Project Timesheet

GET api/v3/projects/{project_id}/timesheet

Request Example

$ curl api/v3/projects/{project_id}/timesheet \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "timesheet": [
    {
      "owner": {
        "photo-url": "test-photo-url",
        "name": "Charles",
        "id": "1256498736565975",
        "email": "charles@zmail.com"
      },
      "total_tech_charge": "10.00",
      "total_time_spent": {
        "hours": "02",
        "minutes": "20"
      },
      "total_amount_spent": "18.23",
      "total_other_charge": "3.00"
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project timesheet.

Show All Attributes

Project Member

Efficient staff alone does not ensure a project’s success. Meticulous planning of project staff; the permissions given to a projectrole; the flexibility in changing project roles and more come into play to ensure the project as a whole turns out to be a success.

All Attributes
id

Unique Id of the project member

project

The project to which the project member is associated

user

The user who is going to be referred as project member

role

The role of the project member in that project

is_active

Denotes whether the member is active or not in that project

Add Project Member

POST /api/v3/projects/{project_id}/project_members

Request Example

$ curl /api/v3/projects/{project_id}/project_members \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1671916624613897"
    },
    "user": {
      "name": "Lincoln",
      "id": "2015375556926236"
    }
  }
}

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "1758395316914857"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "1837585531052284",
        "title": "test-title"
      },
      "id": "1632239006530784",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2288255677512633",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1671916624613897"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2441504488450900",
      "title": "test-title"
    },
    "id": "2267361141787120",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2015375556926236",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Add project member.

Mandatory Fields :- <user>

Show All Attributes

Update Project Member

PUT /api/v3/projects/{project_id}/project_members/{project_member_id}

Request Example

$ curl /api/v3/projects/{project_id}/project_members/{project_member_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1816145875895667"
    },
    "project": {
      "id": "2135029194005628"
    },
    "user": {
      "name": "Lincoln",
      "id": "1623728661097978"
    }
  }
}

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "1800674385772601"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "1520830468888548",
        "title": "test-title"
      },
      "id": "2448475020842436",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1586437413582837",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1816145875895667"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2135029194005628",
      "title": "test-title"
    },
    "id": "1759920319545029",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1623728661097978",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Update project member.

Show All Attributes

Delete Project Member

DELETE /api/v3/projects/{project_id}/project_members/{project_member_id}

Request Example

$ curl /api/v3/projects/{project_id}/project_members/{project_member_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete project member.

Get Project Member

GET /api/v3/projects/{project_id}/project_members/{project_member_id}

Request Example

$ curl /api/v3/projects/{project_id}/project_members/{project_member_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "1970121712667911"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "1949438813952126",
        "title": "test-title"
      },
      "id": "2268332815694399",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2290274042001780",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1937338285023504"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2435421368082892",
      "title": "test-title"
    },
    "id": "1529152197571919",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2088769770094165",
      "photo_url": "test-photo_url"
    }
  }
}

This operation helps you Get project member.

Show All Attributes

Get All Project Members

GET /api/v3/projects/{project_id}/project_members

Request Example

$ curl /api/v3/projects/{project_id}/project_members \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "1651488601950123"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "2055438302876386",
        "title": "test-title"
      },
      "id": "2312479889819080",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2321003806038719",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all project members.

Show All Attributes

Project Comment

Comments that enable members/administrators to share their views on project for the betterment of the project.

All Attributes
id

Unique identifier of the project comment

project

The project to which the comment is associated

created_by
REFERRED_FIELD(Read-Only)

The user who created the comment

created_time
DATETIME(Read-Only)

The time at which the comment is created

comment

Content of the project comment

Add Project Comment

POST /api/v3/projects/{project_id}/comments

Request Example

$ curl /api/v3/projects/{project_id}/comments \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_comment": {
    "comment": "test-comment"
  }
}

Response Example

{
  "project_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2323413329434334",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "1889135648187917",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2186934143587107",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add project comment.

Mandatory Fields :- <project>,<comment>

Show All Attributes

Update Project Comment

PUT /api/v3/projects/{project_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_comment": {
    "comment": "test-comment"
  }
}

Response Example

{
  "project_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2003918976447691",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "1884869874731530",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2117947944479301",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update project comment.

Show All Attributes

Delete Project Comment

DELETE /api/v3/projects/{project_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete project comment.

Get Project Comment

GET /api/v3/projects/{project_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "project_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "1878727251794484",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "1686434217890665",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1604123307422042",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project comment.

Show All Attributes

Get All Project Comments

GET /api/v3/projects/{project_id}/comments

Request Example

$ curl /api/v3/projects/{project_id}/comments \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "comments": [
    {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "2192453834028874",
        "title": "test-title"
      },
      "comment": "test-comment",
      "id": "2100648863087627",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2417259473166975",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all project comments.

Show All Attributes

Project Task

A task is an activity or piece of work which you have to do, usually as part of a larger project

Add Project Task

POST /api/v3/projects/{project_id}/tasks

Request Example

$ curl /api/v3/projects/{project_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "percentage_completion": 13,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "name": "Lincoln",
      "id": "2283516941295988"
    },
    "priority": {
      "name": "High",
      "id": "1798252458435155"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort": "1505081186575103",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1994371102189359"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 13,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "id": "2375387328358208"
    },
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1539416012908537",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "1953082515058188"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2283516941295988",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1798252458435155"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1810767714399012",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1658404355807607"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "2183281574519585",
      "title": "Create SRS"
    },
    "task_index": "test-task_index",
    "estimated_effort": "1505081186575103",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1732019298196535"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1994371102189359"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add project task.

Mandatory Fields :- <title>

Show All Attributes

Update Project Task

PUT /api/v3/projects/{project_id}/tasks/{task_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "owner": {
      "name": "Lincoln",
      "id": "1518142395260995"
    },
    "percentage_completion": 47,
    "estimated_effort_hours": "20",
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "title": "Create SRS",
    "priority": {
      "name": "High",
      "id": "1577289705984145"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "estimated_effort": "1583078951256278",
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2245075096972942"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2151976926483335"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 47,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "id": "234134234343234"
    },
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1888002207775724",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2289209646793124"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1518142395260995",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1577289705984145"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1675484647602727",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "1858002481022231"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "estimated_effort": "1583078951256278",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2245075096972942"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "2151976926483335"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update project task.

Show All Attributes

Delete Project Task

DELETE /api/v3/projects/{project_id}/tasks/{task_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete project task.

Get Project Task

GET /api/v3/projects/{project_id}/tasks/{task_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "task": {
    "percentage_completion": 3,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "id": "1737991342628323"
    },
    "title": "Create SRS",
    "marked_technician": null,
    "overdue": false,
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "id": "1558878407567499",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2109753351530765"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1626938947249970",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2238486936179914"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2184005405952290",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "marked_group": {
      "name": "Hardware Problems",
      "id": "2182652721824933"
    },
    "site": "Boston",
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "2091288927504486",
      "title": "Create SRS"
    },
    "task_index": "test-task_index",
    "estimated_effort": "1827426711806803",
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2301417840058760"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "in_progress": false,
      "internal_name": "test-internal_name",
      "color": "#ffffff",
      "name": "Open",
      "id": "1816799214484140"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project task.

Show All Attributes

Get All Project Tasks

GET /api/v3/projects/{project_id}/tasks

Request Example

$ curl /api/v3/projects/{project_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  },
  "tasks": [
    {
      "percentage_completion": 31,
      "estimated_effort_hours": "20",
      "email_before": "1536731560033",
      "description": "The SRS must contain all the requirements for the feature",
      "project": {
        "id": "2229876531951151"
      },
      "title": "Create SRS",
      "marked_technician": null,
      "overdue": false,
      "additional_cost": 1343434.4333,
      "actual_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "id": "1549954368102516",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "group": {
        "name": "Hardware Problems",
        "id": "1533115969950077"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1914123510880460",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "project",
      "module": "Project",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2124500291184411"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1574009973971958",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "marked_group": {
        "name": "Hardware Problems",
        "id": "1511749250089062"
      },
      "site": "Boston",
      "estimated_effort_minutes": "45",
      "deleted": false,
      "milestone": {
        "id": "2160716437762227",
        "title": "Create SRS"
      },
      "task_index": "test-task_index",
      "estimated_effort": "2116838724689723",
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1788157973579911"
      },
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "in_progress": false,
        "internal_name": "test-internal_name",
        "color": "#ffffff",
        "name": "Open",
        "id": "2312717518978743"
      }
    }
  ]
}

This operation helps you Get all project tasks.

Show All Attributes

Add Attachment To A Project Task

POST api/v3/projects/{project_id}/tasks/{task_id}/uploads
$ curl api/v3/projects/{project_id}/tasks/{task_id}/uploads \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -F "filename=@local_file_path" -F "addtoattachment=true"

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "files": [
    {
      "content_type": "application/zip",
      "size": "36171",
      "file_id": "4001",
      "name": "test_file.txt",
      "content_url": "/projects/3421234312443123/tasks/43234334341234564/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a project task. Here, the input must be given as multipart - form data.

Mandatory Fields :- <filename>

All Attributes
filename
The path of the file to be uploaded must be given with ’@’ at the beginning of the path
addtoattachment
Denotes whether to add the file as an attachment to the associated entity
The details of the file is contained here
size
The size of the file that is uploaded
content_type
The type of the content of the file
file_id
The file_id is used to add that file as an attachment to the entity
name
The name of the file
content_url
The url of the file that is uploaded

Project Task Comment

Comments that enable members/administrators to share their views on tasks for the betterment of the project.

Attributes

All Attributes
id

Unique identifier of the task comment

task

The task to which the comment is associated

created_by
REFERRED_FIELD(Read-Only)

The user who created the task comment

created_time
DATETIME(Read-Only)

The time at which the task comment is created

comment

Content of the task comment

Add Project Task Comment

POST /api/v3/projects/{project_id}/tasks/{task_id}/comments

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/comments \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task_comment": {
    "task": {
      "id": "1727784386760237"
    },
    "comment": "test-comment"
  }
}

Response Example

{
  "task_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "task": {
      "id": "1727784386760237",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "2448667404566541",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1527236427122327",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add project task comment.

Mandatory Fields :- <comment>

Show All Attributes

Update Project Task Comment

PUT /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task_comment": {
    "task": {
      "id": "1661239895304934"
    },
    "comment": "test-comment"
  }
}

Response Example

{
  "task_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "task": {
      "id": "1661239895304934",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "1922152764699941",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1654002886779241",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update project task comment.

Show All Attributes

Delete Project Task Comment

DELETE /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Delete project task comment.

Get Project Task Comment

GET /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/comments/{comment_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "task_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "task": {
      "id": "1763333003187631",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "2058977795106853",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1761397660689949",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project task comment.

Show All Attributes

Get All Project Task Comments

GET /api/v3/projects/{project_id}/tasks/{task_id}/comments

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/comments \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \

Response Example

{
  "comments": [
    {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "task": {
        "id": "1662003754830410",
        "title": "Create SRS"
      },
      "comment": "test-comment",
      "id": "1710797241607256",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2410667741420768",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all project task comments.

Show All Attributes

Project Task - Worklog

Helps you track and capture the work done by a team member. 

Attributes

All Attributes
id

Unique id of the Worklog

created_by
REFERRED_FIELD(Read-Only)

The user who created the worklog

owner
Owner of the worklog
description

Description about the worklog.

time_spent

The time spent in terms of hours, minutes and seconds.

start_time

Date and time to start the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

end_time

Date and time to end the worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

recorded_time

Date and time of creation of Worklog. JSON Object has the “value” in milliseconds and “display_value” in the standard date format.

other_charge

Extra charges other than the Technician related to the worklog.

total_charge
DOUBLE(Read-Only)

The total charges related to the worklog

tech_charge

The technician charges related to the worklog

Add Worklog For Project Task

POST /api/v3/projects/{project_id}/tasks/{task_id}/worklogs

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "1946058749273113"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    }
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1946058749273113",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1793178899276484",
      "photo_url": "test-photo_url"
    },
    "recorded_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "tech_charge": "15.00",
    "time_spent": {
      "hours": 16800,
      "minutes": 54
    },
    "mark_first_response": false,
    "start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "worklog_type": {
      "name": "test-name",
      "id": "1897858615820226"
    },
    "id": "1918317974982165"
  }
}

This operation helps you Add worklog for project task.

Mandatory Fields :- <owner>

Show All Attributes

Update Worklog For Project Task

PUT /api/v3/projects/{project_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/projects/{project_id}/tasks/{task_id}/worklogs/{worklog_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "2160865444733558"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "2465592427928450"
    },
    "end_time": {
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "recorded_time": {
      "value": "1478758440000"
    },
    "tech_charge": "15.00"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "worklog": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2160865444733558",
      "photo_url": "test-photo_url"
    },
    "include_nonoperational_hours": false,
    "end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "description": "test-description",
    "other_charge": "30.00",
    "total_charge": "45.00",