Skip to content

Problem Task

A task is an activity or piece of work that is a part of a larger problem.

Attributes

id (long)
Indicates the unique ID of the task

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

Example 

234759602834500

title (string)
Title of the task

title (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

template (task_template)
Indicates the template which is used to create this task

template (task_template)
Indicates the template which is used to create this task

Example 

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

description (html)
Contains description about the task

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

Example 

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

scheduled_start_time (datetime)
Date and time at which the task is scheduled to start

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

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

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

scheduled_end_time (datetime)
Date and time at which the task is scheduled to finish

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

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

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

More Attributes Expand all

actual_start_time (datetime)

Date and time at which the task has actually started

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

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

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

actual_end_time (datetime)

Date and time at which the task actually ended

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

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

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

email_before (long)

Indicates when to send a notification before the schedule start in ms.

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

Example 

234759602834500

percentage_completion (int)

Indicates the progress of the task in percentage of completion

percentage_completion (int)
Numerical digits which are considered to have smaller numbers.

Example 

39

additional_cost (double)

Indicates the Cost spent other than the actual cost of the task

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

Example 

23.08

estimated_effort_days (long)

Estimated number of days to finish the task

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

Example 

234759602834500

estimated_effort_hours (long)

Estimated number of hours to finish the task

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

Example 

234759602834500

estimated_effort_minutes (long)

Estimated number of minutes to finish the task

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

Example 

234759602834500

status (status)

Indicates the level of progress of the task

status (status)
Indicates the level of progress of the task

Example 

{
  "status": {
    "name": "test status",
    "id": "13333330000112311"
  }
}

group (group)

Indicates the assigned group of the task

group (group)
Indicates the assigned group of the task

Example 

{
  "group": {
    "name": "group 1",
    "id": "1003333001243212"
  }
}

owner (user)

The User assigned to the task

owner (user)
The User assigned to the task

Example 

{
  "owner": {
    "email_id": "john@zylker.com",
    "name": "John",
    "id": "100000000000220612"
  }
}

marked_technician (user)

The user to be assigned when the task is triggered

marked_technician (user)

priority (priority)

Defines the intensity or importance of a task

priority (priority)

task_type (task_type)

Used to categorize the tasks of similar cases

task_type (task_type)
Used to categorize the tasks of similar cases

Example 

{
  "task_type": {
    "name": "test task_type",
    "id": "10000000023123"
  }
}

attachments (attachment)

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

attachments (attachment)

udf_fields (udf_fields)

Holds user defined fields’ values associated with the task

udf_fields (udf_fields)
Holds user defined fields’ values associated with the task

Example 

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

module (string)read only

The module to which the task belongs

module (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

created_date (datetime)read only

Date and time at which the task is created

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

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

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

created_by (user)read only

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

created_by (user)

estimated_effort (long)read only

The estimated effort needed to finish the task

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

Example 

234759602834500

overdue (boolean)read only

Indicates whether the task is overdue or not

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

associated_entity (string)read only

Entity associated to the task

associated_entity (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

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.

problem (problem)
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.

Example 

{
  "problem": {
    "id": "100000000000032142"
  }
}

Add Problem Task

This operation helps you to add a problem task.

Mandatory Fields :- [“title”]

Url

<service domain|custom domain>/app/<portal>/api/v3/probles/{problem_id}/tasks

Attributes

id (long)
Indicates the unique ID of the task

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

Example 

234759602834500

title (string)
Title of the task

title (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

template (task_template)
Indicates the template which is used to create this task

template (task_template)
Indicates the template which is used to create this task

Example 

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

description (html)
Contains description about the task

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

Example 

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

scheduled_start_time (datetime)
Date and time at which the task is scheduled to start

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

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

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

scheduled_end_time (datetime)
Date and time at which the task is scheduled to finish

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

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

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

More Attributes Expand all

actual_start_time (datetime)

Date and time at which the task has actually started

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

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

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

actual_end_time (datetime)

Date and time at which the task actually ended

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

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

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

email_before (long)

Indicates when to send a notification before the schedule start in ms.

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

Example 

234759602834500

percentage_completion (int)

Indicates the progress of the task in percentage of completion

percentage_completion (int)
Numerical digits which are considered to have smaller numbers.

Example 

39

additional_cost (double)

Indicates the Cost spent other than the actual cost of the task

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

Example 

23.08

estimated_effort_days (long)

Estimated number of days to finish the task

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

Example 

234759602834500

estimated_effort_hours (long)

Estimated number of hours to finish the task

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

Example 

234759602834500

estimated_effort_minutes (long)

Estimated number of minutes to finish the task

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

Example 

234759602834500

status (status)

Indicates the level of progress of the task

status (status)
Indicates the level of progress of the task

Example 

{
  "status": {
    "name": "test status",
    "id": "13333330000112311"
  }
}

group (group)

Indicates the assigned group of the task

group (group)
Indicates the assigned group of the task

Example 

{
  "group": {
    "name": "group 1",
    "id": "1003333001243212"
  }
}

owner (user)

The User assigned to the task

owner (user)
The User assigned to the task

Example 

{
  "owner": {
    "email_id": "john@zylker.com",
    "name": "John",
    "id": "100000000000220612"
  }
}

marked_technician (user)

The user to be assigned when the task is triggered

marked_technician (user)

priority (priority)

Defines the intensity or importance of a task

priority (priority)

task_type (task_type)

Used to categorize the tasks of similar cases

task_type (task_type)
Used to categorize the tasks of similar cases

Example 

{
  "task_type": {
    "name": "test task_type",
    "id": "10000000023123"
  }
}

attachments (attachment)

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

attachments (attachment)

udf_fields (udf_fields)

Holds user defined fields’ values associated with the task

udf_fields (udf_fields)
Holds user defined fields’ values associated with the task

Example 

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

module (string)read only

The module to which the task belongs

module (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

created_date (datetime)read only

Date and time at which the task is created

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

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

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

created_by (user)read only

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

created_by (user)

estimated_effort (long)read only

The estimated effort needed to finish the task

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

Example 

234759602834500

overdue (boolean)read only

Indicates whether the task is overdue or not

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

associated_entity (string)read only

Entity associated to the task

associated_entity (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

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.

problem (problem)
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.

Example 

{
  "problem": {
    "id": "100000000000032142"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/probles/{problem_id}/tasks\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
    "task": {
        "template": {
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "email_before": "1800000",
        "owner": {
            "id": "4149000000871029"
        },
        "status": {
            "id": "4149000000006657"
        },
        "title": "Add Problem Task",
        "description": "<div>Add Task</div>",
        "scheduled_start_time": {
            "value": 1675329240000
        },
        "scheduled_end_time": {
            "value": 1675934040000
        },
        "actual_start_time": {
            "value": 1675415640000
        },
        "actual_end_time": {
            "value": 1675761240000
        },
        "priority": {
            "id": "4149000000006803"
        },
        "estimated_effort_days": "12",
        "percentage_completion": "45",
        "additional_cost": "150",
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    }

    }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/probles/{problem_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "task": {
        "template": {
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "email_before": "1800000",
        "owner": {
            "id": "4149000000871029"
        },
        "status": {
            "id": "4149000000006657"
        },
        "title": "Add Problem Task",
        "description": "<div>Add Task</div>",
        "scheduled_start_time": {
            "value": 1675329240000
        },
        "scheduled_end_time": {
            "value": 1675934040000
        },
        "actual_start_time": {
            "value": 1675415640000
        },
        "actual_end_time": {
            "value": 1675761240000
        },
        "priority": {
            "id": "4149000000006803"
        },
        "estimated_effort_days": "12",
        "percentage_completion": "45",
        "additional_cost": "150",
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    }

    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/probles/{problem_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "template": {
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "email_before": "1800000",
        "owner": {
            "id": "4149000000871029"
        },
        "status": {
            "id": "4149000000006657"
        },
        "title": "Add Problem Task",
        "description": "<div>Add Task</div>",
        "scheduled_start_time": {
            "value": 1675329240000
        },
        "scheduled_end_time": {
            "value": 1675934040000
        },
        "actual_start_time": {
            "value": 1675415640000
        },
        "actual_end_time": {
            "value": 1675761240000
        },
        "priority": {
            "id": "4149000000006803"
        },
        "estimated_effort_days": "12",
        "percentage_completion": "45",
        "additional_cost": "150",
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    }

    }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/probles/{problem_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "template": {
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "email_before": "1800000",
        "owner": {
            "id": "4149000000871029"
        },
        "status": {
            "id": "4149000000006657"
        },
        "title": "Add Problem Task",
        "description": "<div>Add Task</div>",
        "scheduled_start_time": {
            "value": 1675329240000
        },
        "scheduled_end_time": {
            "value": 1675934040000
        },
        "actual_start_time": {
            "value": 1675415640000
        },
        "actual_end_time": {
            "value": 1675761240000
        },
        "priority": {
            "id": "4149000000006803"
        },
        "estimated_effort_days": "12",
        "percentage_completion": "45",
        "additional_cost": "150",
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    }

    }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
      "inactive": false,
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "percentage_completion": 45,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "1800000",
        "description": "<div>Add Task<\/div>",
        "title": "Add Problem Task",
        "marked_technician": null,
        "problem": {
            "id": "4149000001305071"
        },
        "overdue": false,
        "additional_cost": "150",
        "actual_end_time": {
            "display_value": "Feb 7, 2023 02:44 PM",
            "value": "1675761240000"
        },
        "id": "4149000001305075",
        "actual_start_time": {
            "display_value": "Feb 3, 2023 02:44 PM",
            "value": "1675415640000"
        },
        "group": null,
        "owner": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "associated_entity": "problem",
        "module": "Problem",
        "index": 1,
        "priority": {
            "color": "#ff6600",
            "name": "Medium",
            "id": "4149000000006803"
        },
        "created_by": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "scheduled_end_time": {
            "display_value": "Feb 9, 2023 02:44 PM",
            "value": "1675934040000"
        },
        "marked_group": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "4149000001242001",
            "is_default": true
        },
        "estimated_effort_minutes": null,
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
        "deleted": false,
        "estimated_effort": "1036800000",
        "created_date": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329299172"
        },
        "estimated_effort_days": "12",
        "task_type": null,
        "scheduled_start_time": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329240000"
        },
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "4149000000006657"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Edit Problem Task

This operation helps you update a problem task.

Url

<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks/{task_id}

Attributes

id (long)
Indicates the unique ID of the task

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

Example 

234759602834500

title (string)
Title of the task

title (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

template (task_template)
Indicates the template which is used to create this task

template (task_template)
Indicates the template which is used to create this task

Example 

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

description (html)
Contains description about the task

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

Example 

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

scheduled_start_time (datetime)
Date and time at which the task is scheduled to start

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

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

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

scheduled_end_time (datetime)
Date and time at which the task is scheduled to finish

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

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

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

More Attributes Expand all

actual_start_time (datetime)

Date and time at which the task has actually started

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

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

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

actual_end_time (datetime)

Date and time at which the task actually ended

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

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

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

email_before (long)

Indicates when to send a notification before the schedule start in ms.

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

Example 

234759602834500

percentage_completion (int)

Indicates the progress of the task in percentage of completion

percentage_completion (int)
Numerical digits which are considered to have smaller numbers.

Example 

39

additional_cost (double)

Indicates the Cost spent other than the actual cost of the task

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

Example 

23.08

estimated_effort_days (long)

Estimated number of days to finish the task

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

Example 

234759602834500

estimated_effort_hours (long)

Estimated number of hours to finish the task

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

Example 

234759602834500

estimated_effort_minutes (long)

Estimated number of minutes to finish the task

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

Example 

234759602834500

status (status)

Indicates the level of progress of the task

status (status)
Indicates the level of progress of the task

Example 

{
  "status": {
    "name": "test status",
    "id": "13333330000112311"
  }
}

group (group)

Indicates the assigned group of the task

group (group)
Indicates the assigned group of the task

Example 

{
  "group": {
    "name": "group 1",
    "id": "1003333001243212"
  }
}

owner (user)

The User assigned to the task

owner (user)
The User assigned to the task

Example 

{
  "owner": {
    "email_id": "john@zylker.com",
    "name": "John",
    "id": "100000000000220612"
  }
}

marked_technician (user)

The user to be assigned when the task is triggered

marked_technician (user)

priority (priority)

Defines the intensity or importance of a task

priority (priority)

task_type (task_type)

Used to categorize the tasks of similar cases

task_type (task_type)
Used to categorize the tasks of similar cases

Example 

{
  "task_type": {
    "name": "test task_type",
    "id": "10000000023123"
  }
}

attachments (attachment)

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

attachments (attachment)

udf_fields (udf_fields)

Holds user defined fields’ values associated with the task

udf_fields (udf_fields)
Holds user defined fields’ values associated with the task

Example 

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

module (string)read only

The module to which the task belongs

module (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

created_date (datetime)read only

Date and time at which the task is created

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

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

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

created_by (user)read only

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

created_by (user)

estimated_effort (long)read only

The estimated effort needed to finish the task

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

Example 

234759602834500

overdue (boolean)read only

Indicates whether the task is overdue or not

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

associated_entity (string)read only

Entity associated to the task

associated_entity (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

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.

problem (problem)
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.

Example 

{
  "problem": {
    "id": "100000000000032142"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks/{task_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
    "task": {
        "description": "<div>Edit Task</div>",
        "priority": {
            "id": "4149000000163189"
        },
        "additional_cost": "250",
        "percentage_completion": "75"
    }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "task": {
        "description": "<div>Edit Task</div>",
        "priority": {
            "id": "4149000000163189"
        },
        "additional_cost": "250",
        "percentage_completion": "75"
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks/{task_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "description": "<div>Edit Task</div>",
        "priority": {
            "id": "4149000000163189"
        },
        "additional_cost": "250",
        "percentage_completion": "75"
    }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "description": "<div>Edit Task</div>",
        "priority": {
            "id": "4149000000163189"
        },
        "additional_cost": "250",
        "percentage_completion": "75"
    }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
      "inactive": false,
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "percentage_completion": 75,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "1800000",
        "description": "<div>Edit Task<\/div>",
        "title": "Add Problem Task",
        "marked_technician": null,
        "problem": {
            "id": "4149000001305071"
        },
        "overdue": false,
        "additional_cost": "250",
        "actual_end_time": {
            "display_value": "Feb 7, 2023 02:44 PM",
            "value": "1675761240000"
        },
        "id": "4149000001305075",
        "actual_start_time": {
            "display_value": "Feb 3, 2023 02:44 PM",
            "value": "1675415640000"
        },
        "group": null,
        "owner": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "associated_entity": "problem",
        "module": "Problem",
        "index": 1,
        "priority": {
            "color": "#006600",
            "name": "Urgent",
            "id": "4149000000163189"
        },
        "created_by": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "scheduled_end_time": {
            "display_value": "Feb 9, 2023 02:44 PM",
            "value": "1675934040000"
        },
        "marked_group": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "4149000001242001",
            "is_default": true
        },
        "estimated_effort_minutes": null,
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
        "deleted": false,
        "estimated_effort": "1036800000",
        "created_date": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329299172"
        },
        "estimated_effort_days": "12",
        "task_type": null,
        "scheduled_start_time": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329240000"
        },
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "4149000000006657"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Get Problem Task

This operation helps you get a problem task.

Url

<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}

Attributes

id (long)
Indicates the unique ID of the task

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

Example 

234759602834500

title (string)
Title of the task

title (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

template (task_template)
Indicates the template which is used to create this task

template (task_template)
Indicates the template which is used to create this task

Example 

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

description (html)
Contains description about the task

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

Example 

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

scheduled_start_time (datetime)
Date and time at which the task is scheduled to start

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

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

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

scheduled_end_time (datetime)
Date and time at which the task is scheduled to finish

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

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

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

More Attributes Expand all

actual_start_time (datetime)

Date and time at which the task has actually started

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

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

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

actual_end_time (datetime)

Date and time at which the task actually ended

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

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

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

email_before (long)

Indicates when to send a notification before the schedule start in ms.

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

Example 

234759602834500

percentage_completion (int)

Indicates the progress of the task in percentage of completion

percentage_completion (int)
Numerical digits which are considered to have smaller numbers.

Example 

39

additional_cost (double)

Indicates the Cost spent other than the actual cost of the task

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

Example 

23.08

estimated_effort_days (long)

Estimated number of days to finish the task

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

Example 

234759602834500

estimated_effort_hours (long)

Estimated number of hours to finish the task

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

Example 

234759602834500

estimated_effort_minutes (long)

Estimated number of minutes to finish the task

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

Example 

234759602834500

status (status)

Indicates the level of progress of the task

status (status)
Indicates the level of progress of the task

Example 

{
  "status": {
    "name": "test status",
    "id": "13333330000112311"
  }
}

group (group)

Indicates the assigned group of the task

group (group)
Indicates the assigned group of the task

Example 

{
  "group": {
    "name": "group 1",
    "id": "1003333001243212"
  }
}

owner (user)

The User assigned to the task

owner (user)
The User assigned to the task

Example 

{
  "owner": {
    "email_id": "john@zylker.com",
    "name": "John",
    "id": "100000000000220612"
  }
}

marked_technician (user)

The user to be assigned when the task is triggered

marked_technician (user)

priority (priority)

Defines the intensity or importance of a task

priority (priority)

task_type (task_type)

Used to categorize the tasks of similar cases

task_type (task_type)
Used to categorize the tasks of similar cases

Example 

{
  "task_type": {
    "name": "test task_type",
    "id": "10000000023123"
  }
}

attachments (attachment)

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

attachments (attachment)

udf_fields (udf_fields)

Holds user defined fields’ values associated with the task

udf_fields (udf_fields)
Holds user defined fields’ values associated with the task

Example 

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

module (string)read only

The module to which the task belongs

module (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

created_date (datetime)read only

Date and time at which the task is created

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

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

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

created_by (user)read only

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

created_by (user)

estimated_effort (long)read only

The estimated effort needed to finish the task

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

Example 

234759602834500

overdue (boolean)read only

Indicates whether the task is overdue or not

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

associated_entity (string)read only

Entity associated to the task

associated_entity (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

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.

problem (problem)
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.

Example 

{
  "problem": {
    "id": "100000000000032142"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
      "inactive": false,
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "percentage_completion": 75,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "1800000",
        "description": "<div>Edit Task<br /><\/div>",
        "title": "Add Problem Task",
        "marked_technician": null,
        "problem": {
            "display_id": {
                "display_value": "PB-133",
                "value": "133"
            },
            "id": "4149000001305071",
            "title": "Test Problem"
        },
        "overdue": false,
        "additional_cost": "250",
        "actual_end_time": {
            "display_value": "Feb 7, 2023 02:44 PM",
            "value": "1675761240000"
        },
        "id": "4149000001305075",
        "actual_start_time": {
            "display_value": "Feb 3, 2023 02:44 PM",
            "value": "1675415640000"
        },
        "group": null,
        "owner": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "associated_entity": "problem",
        "module": "Problem",
        "index": 1,
        "priority": {
            "color": "#006600",
            "name": "Urgent",
            "id": "4149000000163189"
        },
        "created_by": {
            "email_id": "john@zylker.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "John",
            "id": "4149000000871029",
            "photo_url": "https://contacts.localzoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "John",
            "job_title": null
        },
        "scheduled_end_time": {
            "display_value": "Feb 9, 2023 02:44 PM",
            "value": "1675934040000"
        },
        "marked_group": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "4149000001242001",
            "is_default": true
        },
        "estimated_effort_minutes": null,
        "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
        "deleted": false,
        "estimated_effort": "1036800000",
        "created_date": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329299172"
        },
        "estimated_effort_days": "12",
        "task_type": null,
        "scheduled_start_time": {
            "display_value": "Feb 2, 2023 02:44 PM",
            "value": "1675329240000"
        },
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "4149000000006657"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Get List Problem Task

This operation helps you get all problem tasks.

Url

<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks

Attributes

id (long)
Indicates the unique ID of the task

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

Example 

234759602834500

title (string)
Title of the task

title (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

template (task_template)
Indicates the template which is used to create this task

template (task_template)
Indicates the template which is used to create this task

Example 

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

description (html)
Contains description about the task

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

Example 

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

scheduled_start_time (datetime)
Date and time at which the task is scheduled to start

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

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

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

scheduled_end_time (datetime)
Date and time at which the task is scheduled to finish

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

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

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

More Attributes Expand all

actual_start_time (datetime)

Date and time at which the task has actually started

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

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

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

actual_end_time (datetime)

Date and time at which the task actually ended

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

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

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

email_before (long)

Indicates when to send a notification before the schedule start in ms.

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

Example 

234759602834500

percentage_completion (int)

Indicates the progress of the task in percentage of completion

percentage_completion (int)
Numerical digits which are considered to have smaller numbers.

Example 

39

additional_cost (double)

Indicates the Cost spent other than the actual cost of the task

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

Example 

23.08

estimated_effort_days (long)

Estimated number of days to finish the task

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

Example 

234759602834500

estimated_effort_hours (long)

Estimated number of hours to finish the task

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

Example 

234759602834500

estimated_effort_minutes (long)

Estimated number of minutes to finish the task

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

Example 

234759602834500

status (status)

Indicates the level of progress of the task

status (status)
Indicates the level of progress of the task

Example 

{
  "status": {
    "name": "test status",
    "id": "13333330000112311"
  }
}

group (group)

Indicates the assigned group of the task

group (group)
Indicates the assigned group of the task

Example 

{
  "group": {
    "name": "group 1",
    "id": "1003333001243212"
  }
}

owner (user)

The User assigned to the task

owner (user)
The User assigned to the task

Example 

{
  "owner": {
    "email_id": "john@zylker.com",
    "name": "John",
    "id": "100000000000220612"
  }
}

marked_technician (user)

The user to be assigned when the task is triggered

marked_technician (user)

priority (priority)

Defines the intensity or importance of a task

priority (priority)

task_type (task_type)

Used to categorize the tasks of similar cases

task_type (task_type)
Used to categorize the tasks of similar cases

Example 

{
  "task_type": {
    "name": "test task_type",
    "id": "10000000023123"
  }
}

attachments (attachment)

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

attachments (attachment)

udf_fields (udf_fields)

Holds user defined fields’ values associated with the task

udf_fields (udf_fields)
Holds user defined fields’ values associated with the task

Example 

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

module (string)read only

The module to which the task belongs

module (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

created_date (datetime)read only

Date and time at which the task is created

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

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

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

created_by (user)read only

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

created_by (user)

estimated_effort (long)read only

The estimated effort needed to finish the task

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

Example 

234759602834500

overdue (boolean)read only

Indicates whether the task is overdue or not

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

associated_entity (string)read only

Entity associated to the task

associated_entity (string)
A text in a plain format. No rich text or new line characters allowed.

Example 

Sample Content

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.

problem (problem)
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.

Example 

{
  "problem": {
    "id": "100000000000032142"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data=''

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = ;
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @''@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/problems/{problem_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = ''''''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "row_count": 1
    },
    "tasks": [
        {
            "template": {
      "inactive": false,
      "name": "Default Task",
      "id": "1822002620872075"
    },
            "percentage_completion": 75,
            "estimated_effort_hours": null,
            "attachments": [],
            "email_before": "1800000",
            "description": "<div>Edit Task<br /><\/div>",
            "title": "Add Problem Task",
            "marked_technician": null,
            "problem": {
                "display_id": {
                    "display_value": "PB-133",
                    "value": "133"
                },
                "id": "4149000001305071",
                "title": "Test Problem"
            },
            "overdue": false,
            "additional_cost": "250",
            "actual_end_time": {
                "display_value": "Feb 7, 2023 02:44 PM",
                "value": "1675761240000"
            },
            "id": "4149000001305075",
            "actual_start_time": {
                "display_value": "Feb 3, 2023 02:44 PM",
                "value": "1675415640000"
            },
            "group": null,
            "owner": {
                "email_id": "john@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": null,
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "4149000001242001",
                    "is_default": true
                },
                "phone": null,
                "employee_id": null,
                "name": "John",
                "id": "4149000000871029",
                "photo_url": "https://contacts.localzoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "John",
                "job_title": null
            },
            "associated_entity": "problem",
            "module": "Problem",
            "index": 1,
            "priority": {
                "color": "#006600",
                "name": "Urgent",
                "id": "4149000000163189"
            },
            "created_by": {
                "email_id": "john@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": null,
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "4149000001242001",
                    "is_default": true
                },
                "phone": null,
                "employee_id": null,
                "name": "John",
                "id": "4149000000871029",
                "photo_url": "https://contacts.localzoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "John",
                "job_title": null
            },
            "scheduled_end_time": {
                "display_value": "Feb 9, 2023 02:44 PM",
                "value": "1675934040000"
            },
            "marked_group": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "4149000001242001",
                "is_default": true
            },
            "estimated_effort_minutes": null,
            "udf_fields": {
      "udf_long1": "1563389026964443",
      "udf_date1": {
        "display_value": "Nov 10, 2016 11:44 AM",
        "value": "1478758440000"
      },
      "udf_char1": "test-udf_char1"
    },
            "deleted": false,
            "estimated_effort": "1036800000",
            "created_date": {
                "display_value": "Feb 2, 2023 02:44 PM",
                "value": "1675329299172"
            },
            "estimated_effort_days": "12",
            "task_type": null,
            "scheduled_start_time": {
                "display_value": "Feb 2, 2023 02:44 PM",
                "value": "1675329240000"
            },
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "stop_timer": false,
                "color": "#0066ff",
                "name": "Open",
                "id": "4149000000006657"
            }
        }
    ]
}

Delete Problem Task

This operation helps you delete a problem task.

Url

<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}


$ curl <service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/problem/{problem_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

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