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

template (task_template)
Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

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

status (status)

stage (release_stage)
Unique identifier of the stage.

stage (release_stage)

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

owner (technician)

More Attributes Expand all

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.

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.

email_before (long)

Time set to trigger notification to owner.

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

Example 

234759602834500

site (site)read only

No Description

site (site)

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

overdue (boolean)read only

OverDue of the Task.

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

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.

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.

type (task_type)

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

type (task_type)

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.

priority (priority)

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

priority (priority)

created_by (user)read only

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

created_by (user)

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.
show attribute

estimated_effort (JSONObject)

group (support_group)

Denotes the classification of the Helpdesk team who handles the task.

group (support_group)

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

index (long)read only

Index of the task.

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

Example 

234759602834500

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)

marked_group (support_group)

Represents the group marked to do the task.

marked_group (support_group)

Add Release Task

This operation helps you add a new task.

Mandatory Fields :- title, stage

Url

<service domain|custom domain>/app/<portal>//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

template (task_template)
Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

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

status (status)

stage (release_stage)
Unique identifier of the stage.

stage (release_stage)

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

owner (technician)

More Attributes Expand all

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.

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.

email_before (long)

Time set to trigger notification to owner.

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

Example 

234759602834500

site (site)read only

No Description

site (site)

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

overdue (boolean)read only

OverDue of the Task.

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

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.

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.

type (task_type)

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

type (task_type)

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.

priority (priority)

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

priority (priority)

created_by (user)read only

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

created_by (user)

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.
show attribute

estimated_effort (JSONObject)

group (support_group)

Denotes the classification of the Helpdesk team who handles the task.

group (support_group)

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

index (long)read only

Index of the task.

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

Example 

234759602834500

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)

marked_group (support_group)

Represents the group marked to do the task.

marked_group (support_group)

$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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"
    }
}

Edit Release Task

This operation helps you update an existing task.

Url

<service domain|custom domain>/app/<portal>//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

template (task_template)
Task template from which Task is to be created.

template (task_template)

Example 

{
  "id": "301"
}

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

status (status)

stage (release_stage)
Unique identifier of the stage.

stage (release_stage)

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

owner (technician)

More Attributes Expand all

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.

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.

email_before (long)

Time set to trigger notification to owner.

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

Example 

234759602834500

site (site)read only

No Description

site (site)

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

overdue (boolean)read only

OverDue of the Task.

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

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.

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.

type (task_type)

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

type (task_type)

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.

priority (priority)

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

priority (priority)

created_by (user)read only

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

created_by (user)

estimated_effort (JSONObject)

Estimated effort given in terms of days hours and minutes.
show attribute

estimated_effort (JSONObject)

group (support_group)

Denotes the classification of the Helpdesk team who handles the task.

group (support_group)

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

index (long)read only

Index of the task.

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

Example 

234759602834500

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)

marked_group (support_group)

Represents the group marked to do the task.

marked_group (support_group)

$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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"
    }
}

Get Release Task

This operation helps you view an existing task by ID.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks/{task_id}

Attributes

description (html)
No Description

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

Example 

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


$ curl -G <service domain|custom domain>/app/<portal>//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"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>//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: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>//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 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/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)
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"
    }
}

Get List Release Task

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

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks

Attributes

$ curl -G <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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"
            }
        }
    ]
}

Delete Release Task

This operation helps you delete an existing task by ID.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks/{task_id}


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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"
  }
}

Trigger A Task

This operation helps you trigger an existing task.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks/{task_id}/trigger


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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": "guest@zylker.com",
            "phone": "1122334455",
            "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

Close A Task

This operation helps to close an existing task.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{releases_id}/tasks/{task_id}/close


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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": "guest@zylker.com",
            "phone": "1122334455",
            "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

Assign Task Owner

This operation helps to assign owner for an existing task.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks/{task_id}/assign


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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

Mark Task Owner

This operation helps to mark owner for an existing task.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/tasks/{task_id}/mark


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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": "guest@zylker.com",
            "phone": "1122334455",
            "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": "guest@zylker.com",
            "phone": "1122334455",
            "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

Add Task Dependency

This operation helps to add dependency between two tasks.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/task_dependencies


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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

Remove Task Dependency

This operation helps to remove dependency between two tasks.

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/task_dependencies/{task_dependency_id}


$ curl <service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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 = "<service domain|custom domain>/app/<portal>//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

Get Task Dependencies

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

Url

<service domain|custom domain>/app/<portal>//api/v3/releases/{release_id}/task_dependencies


$ curl -G <service domain|custom domain>/app/<portal>//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"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>//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"};
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>//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"}
$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/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"}
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