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": 
{
  "criteria": [
    {
      "field_name": "status",
      "condition": "is",
      "values": [
        {
          "id": "999992768898001",
          "name": "Open"
        }
      ],
      "logical_operator": "or",
      "children": [
        {
          "field_name": "mode.name",
          "condition": "is",
          "values": [
            "Phone Call"
          ],
          "logical_operator": "and"
        },
        {
          "field_name": "subject",
          "condition": "contains",
          "values": [
            "trial"
          ],
          "logical_operator": "and"
        }
      ]
    }
  ]
}
}


Example for conditions like(A[OR]B)[AND](C[OR]D)
{
  "criteria": [
    {
      "field_name": "priority",
      "condition": "is",
      "values": [
        {
          "id": "999992768898001",
          "name": "High"
        }
      ],
      "logical_operator": "and",
      "children": [
        {
          "field_name": "priority",
          "condition": "is",
          "values": [
            {
              "id": "999992768898331",
              "name": "Urgent"
            }
          ],
          "logical_operator": "and"
        }
      ]
    },
    {
      "field_name": "created_time",
      "condition": "greater than",
      "logical_operator": "and",
      "value": "1537248600000",
      "children": [
        {
          "field_name": "created_time",
          "condition": "lesser than",
          "value": "1537248600000",
          "logical_operator": "and"
        }
      ]
    }
  ]
}
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 task is associated.
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 milestone template to which the task is associated
Example:

"milestone_template": {
      "id":1234543242345234
    }
    
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_updated_on": {
    "display_value": "Nov 10, 2016 11:44 AM",
    "value": "1478758440000"
   },
   "roll_out_plan_updated_by": {
     "email_id": "test@test.com",
     "cost_per_hour": 1343434.4333,
     "name": "test-name",
     "id": "2185903438683149"
    },
   "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_updated_by": {
     "email_id": "test@test.com",
     "cost_per_hour": 1343434.4333,
     "name": "test-name",
     "id": "1906986780606423"
    },
    "back_out_plan_updated_on": {
     "display_value": "Nov 10, 2016 11:44 AM",
     "value": "1478758440000"
    },
   "back_out_plan_description": "backout plan"
 }
        
Describes how the change process will affect the business.
Example :

"impact_details": {
    "impact_details_updated_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "impact_details_updated_by": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "test-name",
      "id": "1837337817579846"
     },
    "impact_details_description": "affects user"
    }
        
Contains the team’s evaluation of the entire life cycle of the initiated change.
Example :

 "review_details": {
   "review_details_updated_by": {
     "email_id": "test@test.com",
     "cost_per_hour": 1343434.4333,
     "name": "test-name",
     "id": "1733498712080329"
    },
    "next_review_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "review_details_updated_on": {
     "display_value": "Nov 10, 2016 11:44 AM",
     "value": "1478758440000"
    },
    "review_details_description": "review details"
   }
        
Lists the tasks involved in the change process.
Example :

 "checklist": {
   "checklist_description": "check list",
   "checklist_updated_on": {
     "display_value": "Nov 10, 2016 11:44 AM",
     "value": "1478758440000"
   },
   "checklist_updated_by": {
     "email_id": "test@test.com",
     "cost_per_hour": 1343434.4333,
     "name": "test-name",
     "id": "1656082205872310"
   }
 }
 
Contains information about change closure.
Example :

"close_details": {
  "close_details_updated_on": {
   "display_value": "Nov 10, 2016 11:44 AM",
   "value": "1478758440000"
  },
 "close_details_description": "close details",
   "closure_code": {
   "name": "test-name",
   "id": "1791511763340510"
  },
  "close_details_updated_by": {
   "email_id": "test@test.com",
   "cost_per_hour": 1343434.4333,
   "name": "test-name",
   "id": "1911615870689227"
  }
 }
        
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" }]


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:
{
  "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:
{
  "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:
{
  "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"
    }
  ]
}
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:
{
  "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 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:
{
  "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:
{
  "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:
{
  "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 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”: &ldquoldquo;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

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": "1699408049842807"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2433406236061547"
      }
    ],
    "group": {
      "name": "Hardware Problems",
      "id": "2096509087771997"
    },
    "requester": {
      "name": "Lincoln",
      "id": "1987052570890177"
    },
    "item": {
      "name": "Install",
      "id": "1978475351852632"
    },
    "level": {
      "name": "Tier 1",
      "id": "1939614431778756"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1920806107616260"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "1921781258206154"
    },
    "priority": {
      "name": "High",
      "id": "2112830884363638"
    },
    "udf_fields": {
      "udf_ref1": {
        "name": "test-name",
        "id": "1862286563597779"
      },
      "udf_boolean1": false,
      "udf_long1": "1851027465470337",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2257666619961780"
      }
    },
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1644307439596664"
    },
    "status": {
      "name": "Open",
      "id": "2478670738509983"
    },
    "template": {
      "name": "Default Template",
      "id": "1869166963086340"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "request_type": {
      "name": "Incident",
      "id": "2297912084225837"
    },
    "description": "Provide me an External Monitor",
    "urgency": {
      "name": "Urgent",
      "id": "2107588997327484"
    },
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2327497134611680"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "1587221066793770"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "2229102104351020"
        }
      }
    },
    "technician": {
      "name": "Charles",
      "id": "1548894480149209"
    },
    "site": {
      "name": "Custom Site",
      "id": "2347614027038592"
    },
    "category": {
      "name": "Software",
      "id": "2119432469427319"
    }
  }
}

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": "1699408049842807"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "2433406236061547"
      }
    ],
    "is_trashed": false,
    "id": "1605062184851097",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "2096509087771997"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1987052570890177",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "1978475351852632"
    },
    "level": {
      "name": "Tier 1",
      "id": "1939614431778756"
    },
    "approval_status": {
      "name": "Approved",
      "id": "1917003338784009"
    },
    "impact": {
      "name": "Affects Business",
      "id": "1920806107616260"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "1921781258206154"
    },
    "sla": {
      "name": "High",
      "id": "1480665181989873"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2112830884363638"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1740023178255011",
      "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_ref1": {
        "name": "test-name",
        "id": "1862286563597779"
      },
      "udf_boolean1": false,
      "udf_long1": "1851027465470337",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2257666619961780"
      }
    },
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1644307439596664"
    },
    "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": "2478670738509983"
    },
    "template": {
      "name": "Default Template",
      "id": "1869166963086340"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "2297912084225837"
    },
    "display_id": "39",
    "time_elapsed": "1731861774498382",
    "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": "2107588997327484"
    },
    "has_request_initiated_change": false,
    "department": {
      "name": "Administration",
      "id": "1880196941129565"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2327497134611680"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "1587221066793770"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "2229102104351020"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "1548894480149209"
    },
    "has_problem": false,
    "due_by_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "has_project": false,
    "site": {
      "name": "Custom Site",
      "id": "2347614027038592"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "2119432469427319"
    }
  },
  "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": "1732242333075153"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "request_type": {
      "name": "Incident",
      "id": "1777406936832847"
    },
    "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": "2082290173766791"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "1670786680456911"
      }
    ],
    "urgency": {
      "name": "Urgent",
      "id": "1910060085941992"
    },
    "group": {
      "name": "Hardware Problems",
      "id": "2370727357211109"
    },
    "requester": {
      "name": "Lincoln",
      "id": "1608936335571689"
    },
    "created_time": {
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "2382228467563166"
    },
    "level": {
      "name": "Tier 1",
      "id": "2355673586228127"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2283703564774442"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2479392729477477"
    },
    "update_reason": "The request is updated for this reason",
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2143884462712643"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2371251616511052"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1667462033622227"
        }
      }
    },
    "technician": {
      "name": "Charles",
      "id": "1787240382544001"
    },
    "priority": {
      "name": "High",
      "id": "2413050082822352"
    },
    "due_by_time": {
      "value": "1478758440000"
    },
    "first_response_due_by_time": {
      "value": "1478758440000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1615910325246116"
    },
    "udf_fields": {
      "udf_ref1": {
        "name": "test-name",
        "id": "1653463451033342"
      },
      "udf_boolean1": false,
      "udf_long1": "2366494398034279",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2431662218328750"
      }
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2407098062920119"
    },
    "category": {
      "name": "Software",
      "id": "1505790100705017"
    },
    "status": {
      "name": "Open",
      "id": "1648998210203863"
    }
  }
}

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": "2082290173766791"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "1670786680456911"
      }
    ],
    "is_trashed": false,
    "id": "2422932916114876",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "2370727357211109"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1608936335571689",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "2382228467563166"
    },
    "level": {
      "name": "Tier 1",
      "id": "2355673586228127"
    },
    "approval_status": {
      "name": "Approved",
      "id": "1915938313417510"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2283703564774442"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2479392729477477"
    },
    "update_reason": "The request is updated for this reason",
    "sla": {
      "name": "High",
      "id": "1555081271993099"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2413050082822352"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1890368466108146",
      "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_ref1": {
        "name": "test-name",
        "id": "1653463451033342"
      },
      "udf_boolean1": false,
      "udf_long1": "2366494398034279",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2431662218328750"
      }
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "2407098062920119"
    },
    "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": "1648998210203863"
    },
    "template": {
      "name": "Default Template",
      "id": "1732242333075153"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "1777406936832847"
    },
    "display_id": "39",
    "time_elapsed": "1778596994081960",
    "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": "1910060085941992"
    },
    "has_request_initiated_change": false,
    "department": {
      "name": "Administration",
      "id": "2423788879617540"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2143884462712643"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2371251616511052"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1667462033622227"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "1787240382544001"
    },
    "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": "1615910325246116"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "1505790100705017"
    }
  },
  "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": "1582136825581957"
    },
    "assets": [
      {
        "name": "Keyboard ",
        "id": "1897291055918499"
      }
    ],
    "is_trashed": false,
    "id": "2252887505905782",
    "assigned_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "group": {
      "site": "Custom Site",
      "name": "Hardware Problems",
      "id": "1835601331301366"
    },
    "requester": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2341070951601343",
      "photo_url": "test-photo_url"
    },
    "email_to": [],
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "item": {
      "name": "Install",
      "id": "2200569283046151"
    },
    "level": {
      "name": "Tier 1",
      "id": "1758831154797503"
    },
    "approval_status": {
      "name": "Approved",
      "id": "1486807984821549"
    },
    "impact": {
      "name": "Affects Business",
      "id": "2286749055492899"
    },
    "service_category": {
      "name": "Corporate Website",
      "id": "2209862039656670"
    },
    "update_reason": "The request is updated for this reason",
    "sla": {
      "name": "High",
      "id": "2220781091013495"
    },
    "resolved_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1801461785664683"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2166129369846296",
      "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_ref1": {
        "name": "test-name",
        "id": "1643795374365238"
      },
      "udf_boolean1": false,
      "udf_long1": "2136893249551252",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2180842355292531"
      }
    },
    "status_change_comments": "The necessary task is done, so changing the status",
    "impact_details": "Details of the impact",
    "subcategory": {
      "name": "Adobe Reader",
      "id": "1689384297783158"
    },
    "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": "2030469953647589"
    },
    "template": {
      "name": "Default Template",
      "id": "1621542570643245"
    },
    "email_ids_to_notify": [
      "andrews@zmail.com"
    ],
    "attachments": [],
    "request_type": {
      "name": "Incident",
      "id": "1506306323232023"
    },
    "display_id": "39",
    "time_elapsed": "1565454609874887",
    "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": "1649608280235590"
    },
    "has_request_initiated_change": false,
    "request_template_task_ids": [
      {
        "id": "2252461567751168",
        "title": "Create SRS"
      }
    ],
    "department": {
      "name": "Administration",
      "id": "2479581589137258"
    },
    "is_reopened": false,
    "has_draft": false,
    "has_attachments": false,
    "has_linked_requests": false,
    "resources": {
      "res_[\\d]+": {
        "qstn_check_[\\d]+": [
          {
            "name": "test-name",
            "id": "2376376511462850"
          }
        ],
        "qstn_text_[\\d]+": {
          "value": "1478758440000"
        },
        "qstn_simple_[\\d]+": {
          "name": "test-name",
          "id": "2473873161926620"
        },
        "qstn_select_[\\d]+": {
          "name": "test-name",
          "id": "1657878589365338"
        }
      }
    },
    "is_overdue": false,
    "technician": {
      "email_id": "test@test.com",
      "cost_per_hour": 1343434.4333,
      "name": "Charles",
      "id": "1800192075001423"
    },
    "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": "2155686941177027"
    },
    "is_first_response_overdue": false,
    "completed_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "email_bcc": [],
    "category": {
      "name": "Software",
      "id": "2255692061217379"
    }
  },
  "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": "2172780754617988",
      "group": {
        "site": "Custom Site",
        "name": "Hardware Problems",
        "id": "1656516518605403"
      },
      "requester": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1668402088353028",
        "photo_url": "test-photo_url"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "approval_status": {
        "name": "Approved",
        "id": "1481840412465607"
      },
      "update_reason": "The request is updated for this reason",
      "sla": {
        "name": "High",
        "id": "2005500894164541"
      },
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2275683211573532"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2172062157929189",
        "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": "1686167126925803"
      },
      "template": {
        "name": "Default Template",
        "id": "1582687453857643"
      },
      "attachments": [],
      "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": "1527479429852432"
      },
      "has_attachments": false,
      "is_overdue": false,
      "technician": {
        "email_id": "test@test.com",
        "cost_per_hour": 1343434.4333,
        "name": "Charles",
        "id": "1814010422486346"
      },
      "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": "2215971039699818"
      },
      "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": "1601140932073071"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "1879606636108808",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2311378493706479",
      "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": "1494557006095412"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "2139372963953385",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2157851369009934",
      "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": "1712995895561733"
    },
    "show_to_requester": false,
    "description": "The following is the note for the associated request",
    "id": "1961228311891674",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1721719295088988",
      "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": "1850464624393868"
      },
      "notify_technician": false,
      "show_to_requester": false,
      "description": "The following is the note for the associated request",
      "id": "1934363274572210",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1600474353852386",
        "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": 37
  }
}

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": "2038912093239492"
    },
    "level": 37,
    "associated_entity": "request",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2009748681745785",
      "photo_url": "test-photo_url"
    },
    "id": "1886306280805040",
    "status": {
      "name": "To be Sent",
      "id": "1693483084051989"
    }
  }
}

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": "1982445050528620"
    },
    "level": 0,
    "associated_entity": "request",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1995958161292297",
      "photo_url": "test-photo_url"
    },
    "id": "1546728759568743",
    "status": {
      "name": "To be Sent",
      "id": "1749806780805126"
    }
  }
}

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": "1609912350956587"
      },
      "level": 38,
      "associated_entity": "request",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1697603502347895",
        "photo_url": "test-photo_url"
      },
      "id": "1525768773966238",
      "status": {
        "name": "To be Sent",
        "id": "1582483046379675"
      }
    }
  ],
  "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": "1648463771339362"
    }
  }
}

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": "1648463771339362",
      "photo_url": "test-photo_url"
    },
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "level": 14,
      "associated_entity": "request",
      "id": "1685774150244871"
    },
    "id": "1651444552782281",
    "sent_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "action_taken_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "status": {
      "name": "To be Sent",
      "id": "1775729182902280"
    }
  }
}

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": "1770212103587345",
      "photo_url": "test-photo_url"
    },
    "approval_level": {
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "level": 32,
      "associated_entity": "request",
      "id": "1544075171895998"
    },
    "id": "1520320205512462",
    "sent_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "action_taken_on": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "status": {
      "name": "To be Sent",
      "id": "2205284281984619"
    }
  }
}

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": "1928060837077627",
        "photo_url": "test-photo_url"
      },
      "xpath": {
        "path": "orgroles.udf_ref6",
        "display_name": "General Manager"
      },
      "comments": "Comments for why this entity is approved/rejected",
      "approval_level": {
        "created_time": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "level": 26,
        "associated_entity": "request",
        "id": "1910862025520836"
      },
      "id": "2096164620421839",
      "sent_on": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "action_taken_on": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "status": {
        "name": "To be Sent",
        "id": "1681108700923560"
      }
    }
  ],
  "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

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. 

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

task_type

Used to categorize the tasks of similar cases

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": 34,
    "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"
    },
    "owner": {
      "name": "Lincoln",
      "id": "1832804441340851"
    },
    "priority": {
      "name": "High",
      "id": "1923242582790411"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1558317105712271"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2210136806859841"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 34,
    "request": {
      "display_id": "1892994156600883",
      "subject": "test-subject",
      "id": "2188139818743125"
    },
    "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": "1889907429836646",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1832804441340851",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1923242582790411"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2145347725377462",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1558317105712271"
    },
    "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": "2210136806859841"
    }
  },
  "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": "1523858716650262"
    },
    "percentage_completion": 45,
    "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": "1949561176069835"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2166079861958653"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2214592253636328"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 45,
    "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": "1732345372505714",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1523858716650262",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1949561176069835"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2309251178272852",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2166079861958653"
    },
    "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": "2214592253636328"
    }
  },
  "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": 48,
    "request": {
      "display_id": "1997371357532072",
      "subject": "test-subject",
      "id": "1567986752566384"
    },
    "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": "1518784971107201",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1676658680251047",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "request",
    "module": "Request",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2127027562725527"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1747345653798148",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1646918343788996"
    },
    "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": "2259548114024011"
    }
  },
  "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": 39,
      "request": {
        "display_id": "2077878017908832",
        "subject": "test-subject",
        "id": "2142283210458677"
      },
      "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": "1521108144585034",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1548734508795607",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "request",
      "module": "Request",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2265811888605050"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2408621059233478",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "estimated_effort_minutes": "45",
      "deleted": false,
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1487440509573427"
      },
      "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": "2372796174271354"
      }
    }
  ]
}

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": "2269812628696869"
    },
    "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": "1579424163704024"
    }
  }
}

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": "2269812628696869",
      "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": "2352578280957612",
      "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": "1579424163704024"
    },
    "id": "1533502253905235"
  }
}

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": "1545743458585866"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "1959453323451524"
    },
    "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": "1545743458585866",
      "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": "2319057087889811",
      "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": "1959453323451524"
    },
    "id": "2118698095948429"
  }
}

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": "2207799789399350",
      "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": "1654025274922115",
      "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": "1757758838279720"
    },
    "id": "1605581787590798"
  }
}

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": "1931791035252295",
        "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": "2121745837835986",
        "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": "1681925087461426"
      },
      "id": "1733976873804459"
    }
  ]
}

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
No description
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": "2269812628696869"
    },
    "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": "1579424163704024"
    }
  }
}

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": "2269812628696869",
      "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": "2352578280957612",
      "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": "1579424163704024"
    },
    "id": "1533502253905235"
  }
}

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": "1545743458585866"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "1959453323451524"
    },
    "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": "1545743458585866",
      "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": "2319057087889811",
      "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": "1959453323451524"
    },
    "id": "2118698095948429"
  }
}

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": "2207799789399350",
      "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": "1654025274922115",
      "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": "1757758838279720"
    },
    "id": "1605581787590798"
  }
}

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": "1931791035252295",
        "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": "2121745837835986",
        "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": "1681925087461426"
      },
      "id": "1733976873804459"
    }
  ]
}

This operation helps you Get all worklogs for request task.

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

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": "1735015002354938"
    },
    "project_template": {
      "name": "Default",
      "id": "2032555957607057"
    },
    "percentage_completion": 12,
    "project_type": {
      "name": "Business",
      "id": "1635963428970932"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "2451169509004815"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2420612103481141"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_ref1": {
        "name": "test-name",
        "id": "1934567949851275"
      },
      "udf_boolean1": false,
      "udf_long1": "1973773714575239",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2008144815126130"
      }
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2259472243858614"
    }
  }
}

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": "1735015002354938",
      "photo_url": "test-photo_url"
    },
    "project_template": {
      "name": "Default",
      "id": "2032555957607057",
      "title": "test-title"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 12,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "1635963428970932"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2451169509004815"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2339238447735504",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "2420612103481141"
    },
    "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_ref1": {
        "name": "test-name",
        "id": "1934567949851275"
      },
      "udf_boolean1": false,
      "udf_long1": "1973773714575239",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2008144815126130"
      }
    },
    "id": "1671842529145768",
    "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": "2259472243858614"
    }
  }
}

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": "1689106786113393"
    },
    "percentage_completion": 17,
    "project_type": {
      "name": "Business",
      "id": "2058117349391316"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "1894270004868624"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1714455778787940"
    },
    "actual_hours": "15",
    "actual_cost": 1343434.4333,
    "estimated_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "18",
    "udf_fields": {
      "udf_ref1": {
        "name": "test-name",
        "id": "1627881006666799"
      },
      "udf_boolean1": false,
      "udf_long1": "2179499512758977",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2235567922202475"
      }
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1710416201702602"
    }
  }
}

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": "1689106786113393",
      "photo_url": "test-photo_url"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 17,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "2058117349391316"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1894270004868624"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2273383254369586",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1714455778787940"
    },
    "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_ref1": {
        "name": "test-name",
        "id": "1627881006666799"
      },
      "udf_boolean1": false,
      "udf_long1": "2179499512758977",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "2235567922202475"
      }
    },
    "id": "2113526352695352",
    "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": "1710416201702602"
    }
  }
}

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": "1587484404787313",
      "photo_url": "test-photo_url"
    },
    "project_template": {
      "name": "Default",
      "id": "1779114664171740",
      "title": "test-title"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "percentage_completion": 3,
    "project_type": {
      "color": "#ffffff",
      "name": "Business",
      "id": "1794442059040792"
    },
    "description": "test-description",
    "project_code": "test-project_code",
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1835561166195899"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2135457962948315",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "site": {
      "name": "Custom Site",
      "id": "1742499297749232"
    },
    "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_ref1": {
        "name": "test-name",
        "id": "2020997001545358"
      },
      "udf_boolean1": false,
      "udf_long1": "1542010149649202",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_double1": "test-udf_double1",
      "udf_char1": "test-udf_char1",
      "deptheadid": {
        "name": "test-name",
        "id": "1979515554615625"
      }
    },
    "id": "2260572253810177",
    "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": "2420070817799337"
    }
  }
}

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": "2236126005117502",
        "photo_url": "test-photo_url"
      },
      "project_template": {
        "name": "Default",
        "id": "1540291372462114",
        "title": "test-title"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "percentage_completion": 35,
      "project_type": {
        "color": "#ffffff",
        "name": "Business",
        "id": "2361840355516580"
      },
      "description": "test-description",
      "project_code": "test-project_code",
      "title": "test-title",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "1787871250317711"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2316825114134144",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "site": {
        "name": "Custom Site",
        "id": "1665405156458543"
      },
      "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_ref1": {
          "name": "test-name",
          "id": "1908274497804598"
        },
        "udf_boolean1": false,
        "udf_long1": "2317443811344938",
        "udf_date1": {
          "display_value": "Nov 10, 2016 11:44 AM",
          "value": "1478758440000"
        },
        "udf_double1": "test-udf_double1",
        "udf_char1": "test-udf_char1",
        "deptheadid": {
          "name": "test-name",
          "id": "1562855205014303"
        }
      },
      "id": "2409650835010391",
      "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": "1992147205538807"
      }
    }
  ],
  "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": "2312471998792321"
    },
    "user": {
      "name": "Lincoln",
      "id": "1605351457877312"
    }
  }
}

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "2043395531547701"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "2369291538621382",
        "title": "test-title"
      },
      "id": "2005181680614991",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2377908120926779",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "2312471998792321"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2345700032503431",
      "title": "test-title"
    },
    "id": "1781066024663752",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1605351457877312",
      "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": "2149956989835930"
    },
    "project": {
      "id": "2285695030344529"
    },
    "user": {
      "name": "Lincoln",
      "id": "1653312950452879"
    }
  }
}

Response Example

{
  "project_members": [
    {
      "is_active": false,
      "role": {
        "name": "test-name",
        "id": "1503820707031952"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "1988923787738261",
        "title": "test-title"
      },
      "id": "1498178343211884",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1866245510292577",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "2149956989835930"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "2285695030344529",
      "title": "test-title"
    },
    "id": "2161503841124396",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1653312950452879",
      "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": "2379319981175205"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "2477674470577812",
        "title": "test-title"
      },
      "id": "2157684270270241",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1674536733902720",
        "photo_url": "test-photo_url"
      }
    }
  ],
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_member": {
    "is_active": false,
    "role": {
      "name": "test-name",
      "id": "1522445158551528"
    },
    "project": {
      "project_code": "test-project_code",
      "id": "1664651593969498",
      "title": "test-title"
    },
    "id": "1767058709393688",
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2202086327030419",
      "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": "1980346600553050"
      },
      "project": {
        "project_code": "test-project_code",
        "id": "1611330571525727",
        "title": "test-title"
      },
      "id": "2190108461891997",
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2090182362024904",
        "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": "1776954996035331",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "1596101188859425",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2123110054388503",
      "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": "2094295127768854",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "2042863382383031",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2134992495773342",
      "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": "1738864389548573",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "2389739858966352",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2472467307800090",
      "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": "1683207759604977",
        "title": "test-title"
      },
      "comment": "test-comment",
      "id": "1632988663860253",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2264196658841690",
        "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": 34,
    "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"
    },
    "owner": {
      "name": "Lincoln",
      "id": "1832804441340851"
    },
    "priority": {
      "name": "High",
      "id": "1923242582790411"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1558317105712271"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2210136806859841"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 34,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "project_code": "test-project_code",
      "id": "2169454349998021",
      "title": "Create SRS"
    },
    "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": "1889907429836646",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1832804441340851",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1923242582790411"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2145347725377462",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "1508048074996569",
      "title": "Create SRS"
    },
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1558317105712271"
    },
    "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": "2210136806859841"
    }
  },
  "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": "1523858716650262"
    },
    "percentage_completion": 45,
    "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": "1949561176069835"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2166079861958653"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2214592253636328"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 45,
    "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": "1732345372505714",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1523858716650262",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1949561176069835"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2309251178272852",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2166079861958653"
    },
    "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": "2214592253636328"
    }
  },
  "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": 48,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "project_code": "test-project_code",
      "id": "1532033769491213",
      "title": "Create SRS"
    },
    "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": "1518784971107201",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1676658680251047",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2127027562725527"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1747345653798148",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "1611723639757180",
      "title": "Create SRS"
    },
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1646918343788996"
    },
    "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": "2259548114024011"
    }
  },
  "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": 39,
      "estimated_effort_hours": "20",
      "attachments": [],
      "email_before": "1536731560033",
      "description": "The SRS must contain all the requirements for the feature",
      "project": {
        "project_code": "test-project_code",
        "id": "2057613561154352",
        "title": "Create SRS"
      },
      "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": "1521108144585034",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1548734508795607",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "project",
      "module": "Project",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2265811888605050"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2408621059233478",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "estimated_effort_minutes": "45",
      "deleted": false,
      "milestone": {
        "id": "2224961882481182",
        "title": "Create SRS"
      },
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1487440509573427"
      },
      "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": "2372796174271354"
      }
    }
  ]
}

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": "2313646583875704"
    },
    "comment": "test-comment"
  }
}

Response Example

{
  "task_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "task": {
      "id": "2313646583875704",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "1482317578450142",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2447769319787545",
      "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": "1799145252048307"
    },
    "comment": "test-comment"
  }
}

Response Example

{
  "task_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "task": {
      "id": "1799145252048307",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "1790655045925506",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1670850886999035",
      "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": "2075535357499919",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "1528589867273735",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1700447616897543",
      "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": "2411089812337002",
        "title": "Create SRS"
      },
      "comment": "test-comment",
      "id": "2416289938970764",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2438779847587578",
        "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
No description
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": "2269812628696869"
    },
    "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": "1579424163704024"
    }
  }
}

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": "2269812628696869",
      "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": "2352578280957612",
      "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": "1579424163704024"
    },
    "id": "1533502253905235"
  }
}

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": "1545743458585866"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "1959453323451524"
    },
    "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": "1545743458585866",
      "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": "2319057087889811",
      "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": "1959453323451524"
    },
    "id": "2118698095948429"
  }
}

This operation helps you Update worklog for project task.

Show All Attributes

Delete Worklog For Project Task

DELETE /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" \

Response Example

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

This operation helps you Delete worklog for project task.

Get Worklog For Project Task

GET /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" \

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": "2207799789399350",
      "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": "1654025274922115",
      "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": "1757758838279720"
    },
    "id": "1605581787590798"
  }
}

This operation helps you Get worklog for project task.

Show All Attributes

Get All Worklogs For Project Task

GET /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" \

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": "1931791035252295",
        "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": "2121745837835986",
        "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": "1681925087461426"
      },
      "id": "1733976873804459"
    }
  ]
}

This operation helps you Get all worklogs for project task.

Show All Attributes

Milestone

Milestones help you plan the project, decide its various stages, and also serve as landmarks that identify how close a project is on the verge of completion.

All Attributes
id

Unique identifier of the milestone

project
REFERRED_FIELD(Read-Only)

Project to which the milestone is associated

title

Title of the milestone.

owner

The user to which the milestone is assigned

priority

Priority/importance of the milestone

status

Status of the milestone

user
REFERRED_FIELD(Read-Only)

This attribute holds the ID of user who created the milestone.

created_time
DATETIME(Read-Only)

Denotes the created time of the milestone. 

scheduled_start_time

Denotes the scheduled starting time of the milestone.

scheduled_end_time

Denotes the scheduled ending time of the milestone.

actual_start_time

Denotes the actual starting time of the milestone.

actual_end_time

Denotes the actual ending time of the milestone.

index

Index of the milestone

estimated_hours

Denotes the hours planned to complete the milestone

actual_hours

Denotes the actual hours required to complete the milestone

projected_end

Denotes the planned due time of the milestone.

description

Description of the milestone

Add Milestone

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "milestone": {
    "owner": {
      "name": "Lincoln",
      "id": "2394829129305996"
    },
    "index": 40,
    "description": "test-description",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "2181183157505677"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "actual_hours": "1824304226496170",
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "2084904485294258",
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1812650764253030"
    }
  }
}

Response Example

{
  "milestone": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2394829129305996",
      "photo_url": "test-photo_url"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "index": 40,
    "description": "test-description",
    "project": {
      "project_code": "test-project_code",
      "id": "2367097392789037",
      "title": "test-title"
    },
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2181183157505677"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "actual_hours": "1824304226496170",
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "2084904485294258",
    "id": "2079277210172771",
    "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"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1917246997040057",
      "photo_url": "test-photo_url"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "1812650764253030"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add milestone.

Mandatory Fields :- <project>,<title>

Show All Attributes

Update Milestone

PUT /api/v3/projects/{project_id}/milestones/{milestone_id}

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "milestone": {
    "owner": {
      "name": "Lincoln",
      "id": "1737345573358753"
    },
    "index": 40,
    "description": "test-description",
    "title": "test-title",
    "priority": {
      "name": "High",
      "id": "2275398610439761"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "actual_hours": "2443579647003947",
    "actual_end_time": {
      "value": "1512974940000"
    },
    "estimated_hours": "2305590733623488",
    "actual_start_time": {
      "value": "1421988300000"
    },
    "projected_end": {
      "value": "1512974940000"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "1954463371711489"
    }
  }
}

Response Example

{
  "milestone": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1737345573358753",
      "photo_url": "test-photo_url"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "index": 40,
    "description": "test-description",
    "project": {
      "project_code": "test-project_code",
      "id": "1792539404498220",
      "title": "test-title"
    },
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2275398610439761"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "actual_hours": "2443579647003947",
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "2305590733623488",
    "id": "2099565837360104",
    "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"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1617049443766156",
      "photo_url": "test-photo_url"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "1954463371711489"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update milestone.

Show All Attributes

Delete Milestone

DELETE /api/v3/projects/{project_id}/milestones/{milestone_id}

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone.

Get Milestone

GET /api/v3/projects/{project_id}/milestones/{milestone_id}

Request Example

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

Response Example

{
  "milestone": {
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2435403243865340",
      "photo_url": "test-photo_url"
    },
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "index": 41,
    "description": "test-description",
    "project": {
      "project_code": "test-project_code",
      "id": "1895668123588340",
      "title": "test-title"
    },
    "title": "test-title",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2180293654073681"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "actual_hours": "2117228308598297",
    "actual_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_hours": "2396467267492771",
    "id": "1767495881975554",
    "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"
    },
    "user": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1653551953322449",
      "photo_url": "test-photo_url"
    },
    "scheduled_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "status": {
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "id": "2092883998510117"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get milestone.

Show All Attributes

Get All Milestones

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones \
      -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
  },
  "milestones": [
    {
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1862072777095248",
        "photo_url": "test-photo_url"
      },
      "created_time": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "index": 49,
      "description": "test-description",
      "project": {
        "project_code": "test-project_code",
        "id": "2025088634477393",
        "title": "test-title"
      },
      "title": "test-title",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "1856195576007507"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "actual_hours": "2459001425583866",
      "actual_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "estimated_hours": "1885549293477722",
      "id": "1768143256289503",
      "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"
      },
      "user": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1687276478776385",
        "photo_url": "test-photo_url"
      },
      "scheduled_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "status": {
        "internal_name": "Open",
        "color": "#ffffff",
        "name": "Open",
        "id": "1652044857163293"
      }
    }
  ]
}

This operation helps you Get all milestones.

Show All Attributes

Add Attachment To A Milestone

POST api/v3/projects/{project_id}/milestones/{milestone_id}//uploads
$ curl api/v3/projects/{project_id}/milestones/{milestone_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": "/milestones/4123312432431431/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a milestone. 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

Get Milestone Timesheet

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone timesheet.

Show All Attributes

Milestone Comment

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

All Attributes
id

Unique identifier of the milestone comment

milestone

The milestone to which the comment is associated to

created_by
REFERRED_FIELD(Read-Only)

The user who created the milestone

created_time
DATETIME(Read-Only)

The time at which the comment is created

comment

Content of the milestone comment

Add Milestone Comment

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

Request Example

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

Response Example

{
  "milestone_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "milestone": {
      "id": "1837928649620994",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "2462057774918709",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2139997758712043",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add milestone comment.

Mandatory Fields :- <milestone>,<comment>

Show All Attributes

Update Milestone Comment

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

Request Example

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

Response Example

{
  "milestone_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "milestone": {
      "id": "1947425026811647",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "1798318919828667",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2414236949958350",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update milestone comment.

Show All Attributes

Delete Milestone Comment

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone comment.

Get Milestone Comment

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

Request Example

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

Response Example

{
  "milestone_comment": {
    "created_time": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "milestone": {
      "id": "1750204217903100",
      "title": "test-title"
    },
    "comment": "test-comment",
    "id": "2464425870319154",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1860775789855876",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get milestone comment.

Show All Attributes

Get All Milestone Comments

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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"
      },
      "milestone": {
        "id": "2165648087212887",
        "title": "test-title"
      },
      "comment": "test-comment",
      "id": "1932547604858248",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1514623390484661",
        "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 milestone comments.

Show All Attributes

Milestone Task

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

Add Milestone Task

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "percentage_completion": 34,
    "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"
    },
    "owner": {
      "name": "Lincoln",
      "id": "1832804441340851"
    },
    "priority": {
      "name": "High",
      "id": "1923242582790411"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "1558317105712271"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2210136806859841"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 34,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "project_code": "test-project_code",
      "id": "2169454349998021",
      "title": "Create SRS"
    },
    "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": "1889907429836646",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1832804441340851",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1923242582790411"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2145347725377462",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "1508048074996569",
      "title": "Create SRS"
    },
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1558317105712271"
    },
    "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": "2210136806859841"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add milestone task.

Mandatory Fields :- <title>

Show All Attributes

Update Milestone Task

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "task": {
    "owner": {
      "name": "Lincoln",
      "id": "1523858716650262"
    },
    "percentage_completion": 45,
    "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": "1949561176069835"
    },
    "scheduled_end_time": {
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "additional_cost": 1343434.4333,
    "actual_end_time": {
      "value": "1512974940000"
    },
    "actual_start_time": {
      "value": "1421988300000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "name": "Testing",
      "id": "2166079861958653"
    },
    "scheduled_start_time": {
      "value": "1421988300000"
    },
    "status": {
      "name": "Open",
      "id": "2214592253636328"
    }
  }
}

Response Example

{
  "task": {
    "percentage_completion": 45,
    "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": "1732345372505714",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1523858716650262",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "1949561176069835"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "2309251178272852",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "2166079861958653"
    },
    "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": "2214592253636328"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update milestone task.

Show All Attributes

Delete Milestone Task

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone task.

Get Milestone Task

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

Request Example

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

Response Example

{
  "task": {
    "percentage_completion": 48,
    "estimated_effort_hours": "20",
    "attachments": [],
    "email_before": "1536731560033",
    "description": "The SRS must contain all the requirements for the feature",
    "project": {
      "project_code": "test-project_code",
      "id": "1532033769491213",
      "title": "Create SRS"
    },
    "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": "1518784971107201",
    "actual_start_time": {
      "display_value": "Jan 23, 2015 10:15 AM",
      "value": "1421988300000"
    },
    "owner": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1676658680251047",
      "photo_url": "test-photo_url"
    },
    "associated_entity": "project",
    "module": "Project",
    "priority": {
      "color": "#ffffff",
      "name": "High",
      "id": "2127027562725527"
    },
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1747345653798148",
      "photo_url": "test-photo_url"
    },
    "scheduled_end_time": {
      "display_value": "Dec 11, 2017 12:19 PM",
      "value": "1512974940000"
    },
    "estimated_effort_minutes": "45",
    "deleted": false,
    "milestone": {
      "id": "1611723639757180",
      "title": "Create SRS"
    },
    "created_date": {
      "display_value": "Nov 10, 2016 11:44 AM",
      "value": "1478758440000"
    },
    "estimated_effort_days": "15",
    "task_type": {
      "color": "#ffffff",
      "name": "Testing",
      "id": "1646918343788996"
    },
    "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": "2259548114024011"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get milestone task.

Show All Attributes

Get All Milestone Tasks

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": 39,
      "estimated_effort_hours": "20",
      "attachments": [],
      "email_before": "1536731560033",
      "description": "The SRS must contain all the requirements for the feature",
      "project": {
        "project_code": "test-project_code",
        "id": "2057613561154352",
        "title": "Create SRS"
      },
      "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": "1521108144585034",
      "actual_start_time": {
        "display_value": "Jan 23, 2015 10:15 AM",
        "value": "1421988300000"
      },
      "owner": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "1548734508795607",
        "photo_url": "test-photo_url"
      },
      "associated_entity": "project",
      "module": "Project",
      "priority": {
        "color": "#ffffff",
        "name": "High",
        "id": "2265811888605050"
      },
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2408621059233478",
        "photo_url": "test-photo_url"
      },
      "scheduled_end_time": {
        "display_value": "Dec 11, 2017 12:19 PM",
        "value": "1512974940000"
      },
      "estimated_effort_minutes": "45",
      "deleted": false,
      "milestone": {
        "id": "2224961882481182",
        "title": "Create SRS"
      },
      "created_date": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "estimated_effort_days": "15",
      "task_type": {
        "color": "#ffffff",
        "name": "Testing",
        "id": "1487440509573427"
      },
      "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": "2372796174271354"
      }
    }
  ]
}

This operation helps you Get all milestone tasks.

Show All Attributes

Add Attachment To A Milestone Task

POST api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id}/uploads
$ curl api/v3/projects/{project_id}/milestones/{milestone_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": "/milestones/3421234312443123/tasks/43234334341234564/uploads/4001"
    }
  ]
}

This operation helps you to Add attachment to a milestone 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

Milestone 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 Milestone Task Comment

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

Request Example

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

Response Example

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

This operation helps you Add milestone task comment.

Mandatory Fields :- <comment>

Show All Attributes

Update Milestone Task Comment

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "1799145252048307"
    },
    "comment": "test-comment"
  }
}

Response Example

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

This operation helps you Update milestone task comment.

Show All Attributes

Delete Milestone Task Comment

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone task comment.

Get Milestone Task Comment

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "2075535357499919",
      "title": "Create SRS"
    },
    "comment": "test-comment",
    "id": "1528589867273735",
    "created_by": {
      "email_id": "lincoln@zmail.com",
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "id": "1700447616897543",
      "photo_url": "test-photo_url"
    }
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get milestone task comment.

Show All Attributes

Get All Milestone Task Comments

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "2411089812337002",
        "title": "Create SRS"
      },
      "comment": "test-comment",
      "id": "2416289938970764",
      "created_by": {
        "email_id": "lincoln@zmail.com",
        "sms_mail": "linc123@xys_sms.co",
        "phone": "test-phone",
        "name": "Lincoln",
        "id": "2438779847587578",
        "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 milestone task comments.

Show All Attributes

Milestone 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
No description
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 Milestone Task

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id}/worklogs \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "worklog": {
    "owner": {
      "name": "Lincoln",
      "id": "2269812628696869"
    },
    "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": "1579424163704024"
    }
  }
}

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": "2269812628696869",
      "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": "2352578280957612",
      "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": "1579424163704024"
    },
    "id": "1533502253905235"
  }
}

This operation helps you Add worklog for milestone task.

Mandatory Fields :- <owner>

Show All Attributes

Update Worklog For Milestone Task

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

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "1545743458585866"
    },
    "mark_first_response": false,
    "start_time": {
      "value": "1421988300000"
    },
    "include_nonoperational_hours": false,
    "worklog_type": {
      "name": "test-name",
      "id": "1959453323451524"
    },
    "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": "1545743458585866",
      "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": "2319057087889811",
      "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": "1959453323451524"
    },
    "id": "2118698095948429"
  }
}

This operation helps you Update worklog for milestone task.

Show All Attributes

Delete Worklog For Milestone Task

DELETE /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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 milestone task.

Get Worklog For Milestone Task

GET /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id}/worklogs/{worklog_id}

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "2207799789399350",
      "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": "1654025274922115",
      "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": "1757758838279720"
    },
    "id": "1605581787590798"
  }
}

This operation helps you Get worklog for milestone task.

Show All Attributes

Get All Worklogs For Milestone Task

GET /api/v3/projects/{project_id}/milestones/{milestone_id}/tasks/{task_id}/worklogs

Request Example

$ curl /api/v3/projects/{project_id}/milestones/{milestone_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": "1931791035252295",
        "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": "2121745837835986",
        "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": "1681925087461426"
      },
      "id": "1733976873804459"
    }
  ]
}

This operation helps you Get all worklogs for milestone task.

Show All Attributes

Admin

The Admin module is used to configure the settings for each module to make ServiceDesk Plus available for real time functioning.



Project Type

Project Types classify projects based on the goals to be met. For example, a “business” project.

All Attributes
id

unique identifier of the project type

name

Name used to define the project type. The name should be unique. The default project types available are “Business”, “Infrastructure”, “Maintenance”, and “Research”

color

color code used to identify the project type in the application

description

A short description about Project Type

deleted

Denotes whether the project type is deleted or not

Add Project Type

POST /api/v3/project_types

Request Example

$ curl /api/v3/project_types \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_type": {
    "deleted": false,
    "color": "#ffffff",
    "name": "Business",
    "description": "test-description"
  }
}

Response Example

{
  "project_type": {
    "deleted": false,
    "color": "#ffffff",
    "name": "Business",
    "description": "test-description",
    "id": "2477980849932000"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add project type.

Mandatory Fields :- <name>

Show All Attributes

Update Project Type

PUT /api/v3/project_types/{project_type_id}

Request Example

$ curl /api/v3/project_types/{project_type_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_type": {
    "deleted": false,
    "color": "#ffffff",
    "name": "Business",
    "description": "test-description"
  }
}

Response Example

{
  "project_type": {
    "deleted": false,
    "color": "#ffffff",
    "name": "Business",
    "description": "test-description",
    "id": "2164548445865994"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update project type.

Show All Attributes

Delete Project Type

DELETE /api/v3/project_types/{project_type_id}

Request Example

$ curl /api/v3/project_types/{project_type_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 type.

Get Project Type

GET /api/v3/project_types/{project_type_id}

Request Example

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

Response Example

{
  "project_type": {
    "deleted": false,
    "color": "#ffffff",
    "name": "Business",
    "description": "test-description",
    "id": "2228993248679851"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project type.

Show All Attributes

Get All Project Types

GET /api/v3/project_types

Request Example

$ curl /api/v3/project_types \
      -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
  },
  "project_types": [
    {
      "deleted": false,
      "color": "#ffffff",
      "name": "Business",
      "description": "test-description",
      "id": "2232558850113174"
    }
  ]
}

This operation helps you Get all project types.

Show All Attributes

Project Status

Status of the project

All Attributes
id

Unique identifier of the project status

name

Name of the project status

description

A short description about Project Status

deleted

Denotes whether the status is deleted or not

in_progress

if the project status refers to a complete/pending project

internal_name
STRING(Read-Only)

Internal name for project status

color

color code used to identify the project status in the application

Add Project Status

POST /api/v3/project_statuses

Request Example

$ curl /api/v3/project_statuses \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "id": "2352777363708229"
  }
}

This operation helps you Add project status.

Mandatory Fields :- <name>

Show All Attributes

Update Project Status

PUT /api/v3/project_statuses/{project_status_id}

Request Example

$ curl /api/v3/project_statuses/{project_status_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "id": "1669568604011951"
  }
}

This operation helps you Update project status.

Show All Attributes

Delete Project Status

DELETE /api/v3/project_statuses/{project_status_id}

Request Example

$ curl /api/v3/project_statuses/{project_status_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 status.

Get Project Status

GET /api/v3/project_statuses/{project_status_id}

Request Example

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

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "id": "1914817421245785"
  }
}

This operation helps you Get project status.

Show All Attributes

Get All Project Statuses

GET /api/v3/project_statuses

Request Example

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

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "project_statuses": [
    {
      "in_progress": false,
      "deleted": false,
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "description": "test-description",
      "id": "2429478635289799"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all project statuses.

Show All Attributes

Project Role

Project role or set of access permissions for the project members.

All Attributes
id

unique id of the project role

name

The Role Name is to identify the role and should be unique. Member Roles available by default are : 1. Project Admin: Role that allows members to access/control entire project module (that is,control over all available projects) 2. Project Manager: Role that allows members to access/control an entire project (add, edit and delete Projects) 3. Team Leader: Role that allows members to access/control Milestones (add, edit and delete Milestones) 4. Team Member: Role that allows members to access/control Tasks (add, edit and delete Tasks)

description

A short description about Project Role

deleted

Denotes whether the role is deleted or not

permissions

The permissions for the role

Add Project Role

POST /api/v3/project_roles

Request Example

$ curl /api/v3/project_roles \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_role": {
    "deleted": false,
    "permissions": [
      {
        "id": "2032706084895672"
      }
    ],
    "name": "test-name",
    "description": "test-description"
  }
}

Response Example

{
  "project_role": {
    "deleted": false,
    "permissions": [
      {
        "id": "2032706084895672"
      }
    ],
    "name": "test-name",
    "description": "test-description",
    "id": "2181216789762090"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Add project role.

Mandatory Fields :- <name>,<permissions>

Show All Attributes

Update Project Role

PUT /api/v3/project_roles/{project_role_id}

Request Example

$ curl /api/v3/project_roles/{project_role_id} \
      -H "Accept: application/vnd.manageengine.sdp.v3+json" \
      -H "Authorization: ad88xyszde6c84565aae47dweraf8cc05b" \
      -d 'input_data= {
  "project_role": {
    "deleted": false,
    "permissions": [
      {
        "id": "2466925309100443"
      }
    ],
    "name": "test-name",
    "description": "test-description"
  }
}

Response Example

{
  "project_role": {
    "deleted": false,
    "permissions": [
      {
        "id": "2466925309100443"
      }
    ],
    "name": "test-name",
    "description": "test-description",
    "id": "2113741285931428"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Update project role.

Show All Attributes

Delete Project Role

DELETE /api/v3/project_roles/{project_role_id}

Request Example

$ curl /api/v3/project_roles/{project_role_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 role.

Get Project Role

GET /api/v3/project_roles/{project_role_id}

Request Example

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

Response Example

{
  "project_role": {
    "deleted": false,
    "permissions": [
      {
        "id": "2171403420622522"
      }
    ],
    "name": "test-name",
    "description": "test-description",
    "id": "2174198466252201"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

This operation helps you Get project role.

Show All Attributes

Get All Project Roles

GET /api/v3/project_roles

Request Example

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

Response Example

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "project_roles": [
    {
      "deleted": false,
      "permissions": [
        {
          "id": "1624106654792496"
        }
      ],
      "name": "test-name",
      "description": "test-description",
      "id": "1801185578966795"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

This operation helps you Get all project roles.

Show All Attributes

Project Permission

The access permissions that are to be given for the project

All Attributes
id

Unique Id for the permissions

name

The name of the project permissions

description

The detailed description for the project permissions

Get Project Permission

GET /api/v3/project_permissions/{project_permission_id}

Request Example

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

Response Example

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "project_permission": {
    "name": "test-name",
    "description": "test-description",
    "id": "2333365584441592"
  }
}

This operation helps you Get project permission.

Show All Attributes

Get All Project Permissions

GET /api/v3/project_permissions

Request Example

$ curl /api/v3/project_permissions \
      -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
  },
  "project_permissions": [
    {
      "name": "test-name",
      "description": "test-description",
      "id": "1774353831320852"
    }
  ]
}

This operation helps you Get all project permissions.

Show All Attributes