Skip to content

Release Task

Configuration entity used to manage tasks present in a release.

Attributes

id (long)
Unique identifier 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

description (html)
Has 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. Object has the “value” in milliseconds and “display_value” in the standard date format.

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.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

actual_start_time (datetime)
Date and time at which the task has actually started.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

More Attributes Expand all

actual_end_time (datetime)

Date and time at which the task actually got finished.Object has the “value” in milliseconds and “display_value” in the standard date format.

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)

Time set to trigger notification to owner.

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)

Cost spent other than the actual cost of the task.

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

Example 

23.08

status (status)

Indicates the level of progress of the task. The Object has “id” and/or “name” of the status.

status (status)

owner (technician)

User to whom the task is assigned. Object has the “id” and “name” of the owner.

owner (technician)

marked_owner (technician)

Represents the Technician who is marked to do the task. Object has the “id” and “name” of the owner.

marked_owner (technician)

priority (priority)

Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority.

priority (priority)

type (task_type)

Used to categorize the tasks of similar cases. Object has “id” and/or “name” of the task type.

type (task_type)

template (task_template)

Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.

estimated_effort (JSONObject)

created_time (datetime)read only

Date and time at which the task is created. This object has the “value” in milliseconds and “display_value” in the standard date format.

created_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.

created_by (user)read only

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

created_by (user)

index (long)read only

Index of the task.

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

Example 

234759602834500

overdue (boolean)read only

OverDue of the Task.

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

associated_entity (string)read only

Module to which the task is associated to.

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

Example 

Sample Content

due_by_time (datetime)read only

Date and time at which the task is to set as the due.Object has the “value” in milliseconds and “display_value” in the standard date format.

due_by_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.

Get Task Dependencies

This operation helps to view all task dependencies under a release.

Url

/api/v3/releases/{release_id}/task_dependencies


$ curl -G /api/v3/releases/{release_id}/task_dependencies
      -X GET 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      --data-urlencode input_data = '{
    "stage": {
        "id": "1"
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/task_dependencies";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "stage": {
        "id": "1"
    }
};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/task_dependencies"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "stage": {
        "id": "1"
    }
}
'@
$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 = "/api/v3/releases/{release_id}/task_dependencies"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "stage": {
        "id": "1"
    }
}'''       
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,
        "start_index": 1,
        "row_count": 2
    },
    "task_dependencies": [
        {
            "parent_task": {
                "id": "1",
                "title": "task 1"
            },
            "id": "1",
            "child_task": {
                "id": "2",
                "title": "task 2"
            }
        },
        {
            "parent_task": {
                "id": "1",
                "title": "task 1"
            },
            "id": "2",
            "child_task": {
                "id": "3",
                "title": "task 3"
            }
        }
    ]
}

View more

Get List Release Task

This operation lets you view the details of all tasks under a release.

Url

/api/v3/releases/{release_id}/tasks

Attributes

id (long)
Unique identifier 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

description (html)
Has 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. Object has the “value” in milliseconds and “display_value” in the standard date format.

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.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

actual_start_time (datetime)
Date and time at which the task has actually started.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

More Attributes Expand all

actual_end_time (datetime)

Date and time at which the task actually got finished.Object has the “value” in milliseconds and “display_value” in the standard date format.

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)

Time set to trigger notification to owner.

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)

Cost spent other than the actual cost of the task.

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

Example 

23.08

status (status)

Indicates the level of progress of the task. The Object has “id” and/or “name” of the status.

status (status)

owner (technician)

User to whom the task is assigned. Object has the “id” and “name” of the owner.

owner (technician)

marked_owner (technician)

Represents the Technician who is marked to do the task. Object has the “id” and “name” of the owner.

marked_owner (technician)

priority (priority)

Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority.

priority (priority)

type (task_type)

Used to categorize the tasks of similar cases. Object has “id” and/or “name” of the task type.

type (task_type)

template (task_template)

Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.

estimated_effort (JSONObject)

created_time (datetime)read only

Date and time at which the task is created. This object has the “value” in milliseconds and “display_value” in the standard date format.

created_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.

created_by (user)read only

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

created_by (user)

index (long)read only

Index of the task.

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

Example 

234759602834500

overdue (boolean)read only

OverDue of the Task.

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

associated_entity (string)read only

Module to which the task is associated to.

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

Example 

Sample Content

due_by_time (datetime)read only

Date and time at which the task is to set as the due.Object has the “value” in milliseconds and “display_value” in the standard date format.

due_by_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.

$ curl -G /api/v3/releases/{release_id}/tasks
      -X GET 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      --data-urlencode input_data = '{
    "list_info": {
        "row_count": 100,
        "sort_field": "index",
        "sort_order": "asc",
        "search_criteria": {
            "field": "stage",
            "value": "2",
            "condition": "is"
        }
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "list_info": {
        "row_count": 100,
        "sort_field": "index",
        "sort_order": "asc",
        "search_criteria": {
            "field": "stage",
            "value": "2",
            "condition": "is"
        }
    }
};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "list_info": {
        "row_count": 100,
        "sort_field": "index",
        "sort_order": "asc",
        "search_criteria": {
            "field": "stage",
            "value": "2",
            "condition": "is"
        }
    }
}
'@
$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 = "/api/v3/releases/{release_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "list_info": {
        "row_count": 100,
        "sort_field": "index",
        "sort_order": "asc",
        "search_criteria": {
            "field": "stage",
            "value": "2",
            "condition": "is"
        }
    }
}'''       
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,
        "sort_field": "index",
        "start_index": 1,
        "sort_order": "asc",
        "search_criteria": {
            "condition": "is",
            "field": "stage",
            "value": "2"
        },
        "row_count": 1
    },
    "tasks": [
        {
            "template": null,
            "percentage_completion": 0,
            "release": {
                "short_description": "MSSQL Server service pack upgrade",
                "display_id": "3",
                "id": "3",
                "title": "MSSQL Server service pack upgrade"
            },
            "email_before": "0",
            "description": "Test Description Updated",
            "title": "Test Task Updated",
            "type": null,
            "overdue": false,
            "additional_cost": "0.00",
            "actual_end_time": null,
            "id": "1",
            "actual_start_time": null,
            "group": null,
            "owner": null,
            "created_time": {
                "display_value": "Nov 2, 2020 04:32 PM",
                "value": "1604314956381"
            },
            "associated_entity": "release",
            "index": "1",
            "priority": null,
            "created_by": {
                "email_id": null,
                "name": "administrator",
                "is_vipuser": false,
                "id": "4",
                "department": null
            },
            "due_by_time": null,
            "scheduled_end_time": null,
            "marked_owner": null,
            "marked_group": null,
            "stage": {
                "internal_name": "planning",
                "stage_index": "2",
                "name": "Planning",
                "id": "2"
            },
            "estimated_effort": {
                "display_value": "-",
                "hours": "0",
                "minutes": "0",
                "days": "0"
            },
            "scheduled_start_time": null,
            "status": {
                "color": "#00ffcc",
                "name": "In Progress",
                "id": "6"
            }
        }
    ]
}

Get Release Task

This operation helps you view an existing task by ID.

Url

/api/v3/releases/{release_id}/tasks/{task_id}

Attributes

id (long)
Unique identifier 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

description (html)
Has 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. Object has the “value” in milliseconds and “display_value” in the standard date format.

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.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

actual_start_time (datetime)
Date and time at which the task has actually started.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

More Attributes Expand all

actual_end_time (datetime)

Date and time at which the task actually got finished.Object has the “value” in milliseconds and “display_value” in the standard date format.

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)

Time set to trigger notification to owner.

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)

Cost spent other than the actual cost of the task.

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

Example 

23.08

status (status)

Indicates the level of progress of the task. The Object has “id” and/or “name” of the status.

status (status)

owner (technician)

User to whom the task is assigned. Object has the “id” and “name” of the owner.

owner (technician)

marked_owner (technician)

Represents the Technician who is marked to do the task. Object has the “id” and “name” of the owner.

marked_owner (technician)

priority (priority)

Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority.

priority (priority)

type (task_type)

Used to categorize the tasks of similar cases. Object has “id” and/or “name” of the task type.

type (task_type)

template (task_template)

Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.

estimated_effort (JSONObject)

created_time (datetime)read only

Date and time at which the task is created. This object has the “value” in milliseconds and “display_value” in the standard date format.

created_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.

created_by (user)read only

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

created_by (user)

index (long)read only

Index of the task.

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

Example 

234759602834500

overdue (boolean)read only

OverDue of the Task.

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

associated_entity (string)read only

Module to which the task is associated to.

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

Example 

Sample Content

due_by_time (datetime)read only

Date and time at which the task is to set as the due.Object has the “value” in milliseconds and “display_value” in the standard date format.

due_by_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.

$ curl -G /api/v3/releases/{release_id}/tasks/{task_id}
      -X GET 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      --data-urlencode input_data = '{}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "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 = "/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "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())

{
    "task": {
        "template": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "short_description": "MSSQL Server service pack upgrade",
            "display_id": "3",
            "id": "3",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description",
        "title": "Update contact info",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Nov 2, 2020 04:32 PM",
            "value": "1604314956381"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "scheduled_start_time": null,
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Delete Release Task

This operation helps you delete an existing task by ID.

Url

/api/v3/releases/{release_id}/tasks/{task_id}


$ curl /api/v3/releases/{release_id}/tasks/{task_id}
      -X DELETE 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "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 = "/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "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"
  }
}

Edit Release Task

This operation helps you update an existing task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}

Attributes

id (long)
Unique identifier 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

description (html)
Has 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. Object has the “value” in milliseconds and “display_value” in the standard date format.

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.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

actual_start_time (datetime)
Date and time at which the task has actually started.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

More Attributes Expand all

actual_end_time (datetime)

Date and time at which the task actually got finished.Object has the “value” in milliseconds and “display_value” in the standard date format.

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)

Time set to trigger notification to owner.

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)

Cost spent other than the actual cost of the task.

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

Example 

23.08

status (status)

Indicates the level of progress of the task. The Object has “id” and/or “name” of the status.

status (status)

owner (technician)

User to whom the task is assigned. Object has the “id” and “name” of the owner.

owner (technician)

marked_owner (technician)

Represents the Technician who is marked to do the task. Object has the “id” and “name” of the owner.

marked_owner (technician)

priority (priority)

Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority.

priority (priority)

type (task_type)

Used to categorize the tasks of similar cases. Object has “id” and/or “name” of the task type.

type (task_type)

template (task_template)

Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.

estimated_effort (JSONObject)

created_time (datetime)read only

Date and time at which the task is created. This object has the “value” in milliseconds and “display_value” in the standard date format.

created_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.

created_by (user)read only

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

created_by (user)

index (long)read only

Index of the task.

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

Example 

234759602834500

overdue (boolean)read only

OverDue of the Task.

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

associated_entity (string)read only

Module to which the task is associated to.

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

Example 

Sample Content

due_by_time (datetime)read only

Date and time at which the task is to set as the due.Object has the “value” in milliseconds and “display_value” in the standard date format.

due_by_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.

$ curl /api/v3/releases/{release_id}/tasks/{task_id}
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{
    "task": {
        "title": "Test Task Updated",
        "description": "Test Description Updated"
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "task": {
        "title": "Test Task Updated",
        "description": "Test Description Updated"
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "title": "Test Task Updated",
        "description": "Test Description Updated"
    }
}
'@
$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 = "/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "title": "Test Task Updated",
        "description": "Test Description Updated"
    }
}'''
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": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "short_description": "MSSQL Server service pack upgrade",
            "display_id": "3",
            "id": "3",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description Updated",
        "title": "Test Task Updated",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Nov 2, 2020 04:32 PM",
            "value": "1604314956381"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "scheduled_start_time": null,
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Add Release Task

This operation helps you add a new task.

Mandatory Fields :- title

Url

/api/v3/releases/{release_id}/tasks

Attributes

id (long)
Unique identifier 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

description (html)
Has 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. Object has the “value” in milliseconds and “display_value” in the standard date format.

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.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

actual_start_time (datetime)
Date and time at which the task has actually started.Object has the “value” in milliseconds and “display_value” in the standard date format.

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.

More Attributes Expand all

actual_end_time (datetime)

Date and time at which the task actually got finished.Object has the “value” in milliseconds and “display_value” in the standard date format.

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)

Time set to trigger notification to owner.

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)

Cost spent other than the actual cost of the task.

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

Example 

23.08

status (status)

Indicates the level of progress of the task. The Object has “id” and/or “name” of the status.

status (status)

owner (technician)

User to whom the task is assigned. Object has the “id” and “name” of the owner.

owner (technician)

marked_owner (technician)

Represents the Technician who is marked to do the task. Object has the “id” and “name” of the owner.

marked_owner (technician)

priority (priority)

Defines the intensity or importance of a task. Object has “id” and/or “name” of the priority.

priority (priority)

type (task_type)

Used to categorize the tasks of similar cases. Object has “id” and/or “name” of the task type.

type (task_type)

template (task_template)

Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.

estimated_effort (JSONObject)

created_time (datetime)read only

Date and time at which the task is created. This object has the “value” in milliseconds and “display_value” in the standard date format.

created_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.

created_by (user)read only

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

created_by (user)

index (long)read only

Index of the task.

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

Example 

234759602834500

overdue (boolean)read only

OverDue of the Task.

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

associated_entity (string)read only

Module to which the task is associated to.

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

Example 

Sample Content

due_by_time (datetime)read only

Date and time at which the task is to set as the due.Object has the “value” in milliseconds and “display_value” in the standard date format.

due_by_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.

$ curl /api/v3/releases/{release_id}/tasks
      -X POST
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{
    "task": {
        "title": "Update contact info",
        "description": "Test Description",
        "status": {
            "id": "6"
        },
        "stage": {
            "id": "2"
        }
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "task": {
        "title": "Update contact info",
        "description": "Test Description",
        "status": {
            "id": "6"
        },
        "stage": {
            "id": "2"
        }
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "title": "Update contact info",
        "description": "Test Description",
        "status": {
            "id": "6"
        },
        "stage": {
            "id": "2"
        }
    }
}
'@
$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 = "/api/v3/releases/{release_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "title": "Update contact info",
        "description": "Test Description",
        "status": {
            "id": "6"
        },
        "stage": {
            "id": "2"
        }
    }
}'''
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": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "short_description": "MSSQL Server service pack upgrade",
            "display_id": "3",
            "id": "3",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description",
        "title": "Update contact info",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Nov 2, 2020 04:32 PM",
            "value": "1604314956381"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "scheduled_start_time": null,
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

Remove Task Dependency

This operation helps to remove dependency between two tasks.

Url

/api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}


$ curl /api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}
      -X DELETE 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "/api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "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 = "/api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "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"
  }
}

View more

Mark Task Owner

This operation helps to mark owner for an existing task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}/mark


$ curl /api/v3/releases/{release_id}/tasks/{task_id}/mark
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{
    "task": {
        "marked_owner": {
            "id": "4"
        }
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}/mark";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "task": {
        "marked_owner": {
            "id": "4"
        }
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}/mark"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "marked_owner": {
            "id": "4"
        }
    }
}
'@
$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 = "/api/v3/releases/{release_id}/tasks/{task_id}/mark"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "marked_owner": {
            "id": "4"
        }
    }
}'''
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": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "id": "2",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description",
        "title": "Update contact info",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "2",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Jan 22, 2023 10:18 AM",
            "value": "1674362939414"
        },
        "associated_entity": "release",
        "index": "2",
        "priority": null,
        "created_by": {
            "email_id": "manikandan.t@zohocorp.com",
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": {
            "email_id": "manikandan.t@zohocorp.com",
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "image_token": "b873caf27db1a82700b7fdc3d9eab5a4fcc81c6f4f851eced7ec8cafb6a8bb241ecbbd7bfae5c5b921849db663be24a2b0a22c9a",
        "scheduled_start_time": null,
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

View more

Assign Task Owner

This operation helps to assign owner for an existing task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}/assign


$ curl /api/v3/releases/{release_id}/tasks/{task_id}/assign
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{
    "task": {
        "owner": {
            "id": "4"
        }
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}/assign";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "task": {
        "owner": {
            "id": "4"
        }
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}/assign"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "owner": {
            "id": "4"
        }
    }
}
'@
$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 = "/api/v3/releases/{release_id}/tasks/{task_id}/assign"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "owner": {
            "id": "4"
        }
    }
}'''
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": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "short_description": "MSSQL Server service pack upgrade",
            "display_id": "3",
            "id": "3",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description Updated",
        "title": "Test Task Updated",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "created_time": {
            "display_value": "Nov 2, 2020 04:32 PM",
            "value": "1604314956381"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "name": "administrator",
            "is_vipuser": false,
            "id": "4",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "scheduled_start_time": null,
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

View more

Close A Task

This operation helps to close an existing task.

Url

/api/v3/releases/{releases_id}/tasks/{task_id}/close


$ curl /api/v3/releases/{releases_id}/tasks/{task_id}/close
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{}'

// Deluge Sample script
url = "/api/v3/releases/{releases_id}/tasks/{task_id}/close";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{releases_id}/tasks/{task_id}/close"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{}
'@
$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 = "/api/v3/releases/{releases_id}/tasks/{task_id}/close"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''
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": null,
        "percentage_completion": 100,
        "attachments": [],
        "release": {
            "id": "2",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description",
        "title": "Update contact info",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": {
            "display_value": "Jan 22, 2023 10:05 AM",
            "value": "1674362142614"
        },
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Jan 22, 2023 10:03 AM",
            "value": "1674362022926"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": "manikandan.t@zohocorp.com",
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "image_token": "57bd2a96802e3ed1057dffee9b1533ef35c53474b53f616502f5b0ecbba289ea68563cfe10dcda77468760a7a9a0056d0de2e0e2",
        "scheduled_start_time": {
            "display_value": "Jan 22, 2023 10:04 AM",
            "value": "1674362040847"
        },
        "status": {
            "color": "#006600",
            "name": "Closed",
            "id": "1"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

View more

Trigger A Task

This operation helps you trigger an existing task.

Url

/api/v3/releases/{release_id}/tasks/{task_id}/trigger


$ curl /api/v3/releases/{release_id}/tasks/{task_id}/trigger
      -X PUT 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/tasks/{task_id}/trigger";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/tasks/{task_id}/trigger"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{}
'@
$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 = "/api/v3/releases/{release_id}/tasks/{task_id}/trigger"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''
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": null,
        "percentage_completion": 0,
        "attachments": [],
        "release": {
            "id": "2",
            "title": "MSSQL Server service pack upgrade"
        },
        "email_before": "0",
        "description": "Test Description",
        "title": "Update contact info",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1",
        "actual_start_time": null,
        "group": null,
        "owner": null,
        "created_time": {
            "display_value": "Jan 22, 2023 10:03 AM",
            "value": "1674362022926"
        },
        "associated_entity": "release",
        "index": "1",
        "priority": null,
        "created_by": {
            "email_id": "manikandan.t@zohocorp.com",
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "marked_owner": null,
        "marked_group": null,
        "stage": {
            "internal_name": "planning",
            "stage_index": "2",
            "name": "Planning",
            "id": "2"
        },
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "image_token": "fd62f75134afb19845004fbc464cd337c1b23f190a8421796dcdb6adb42cf2f55034ff8e28d34b192724212cb347970736b8b3cb",
        "scheduled_start_time": {
            "display_value": "Jan 22, 2023 10:04 AM",
            "value": "1674362040847"
        },
        "status": {
            "color": "#00ffcc",
            "name": "In Progress",
            "id": "6"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

View more

Add Task Dependency

This operation helps to add dependency between two tasks.

Url

/api/v3/releases/{release_id}/task_dependencies


$ curl /api/v3/releases/{release_id}/task_dependencies
      -X POST 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"
      -H "Authorization: authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"
      -H "Content-Type: application/x-www-form-urlencoded"
      -d input_data= '{
    "task_dependency": {
        "parent_task": {
            "id": "1"
        },
        "child_task": {
            "id": "3"
        }
    },
    "stage": {
        "id": "1"
    }
}'

// Deluge Sample script
url = "/api/v3/releases/{release_id}/task_dependencies";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX"};
input_data = {
    "task_dependency": {
        "parent_task": {
            "id": "1"
        },
        "child_task": {
            "id": "3"
        }
    },
    "stage": {
        "id": "1"
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "/api/v3/releases/{release_id}/task_dependencies"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task_dependency": {
        "parent_task": {
            "id": "1"
        },
        "child_task": {
            "id": "3"
        }
    },
    "stage": {
        "id": "1"
    }
}
'@
$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 = "/api/v3/releases/{release_id}/task_dependencies"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "authtoken: 6FXXXXX2-0XXX-XXXX-XXXX-5XXXXXAXXXXX", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task_dependency": {
        "parent_task": {
            "id": "1"
        },
        "child_task": {
            "id": "3"
        }
    },
    "stage": {
        "id": "1"
    }
}'''
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())

{
    "response_status": {
        "status": "success",
        "status_code": 2000
    },
    "task_dependency": {
        "child_task": {
            "id": "3",
            "title": "task 3"
        },
        "id": "2",
        "parent_task": {
            "id": "1",
            "title": "task 1"
        }
    }
}

View more