Skip to content

Change Type

Changes to an IT production environment come in a variety of forms. This can be described as Change Types.

Attributes

id (long)
Unique Identifier of Change type

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

Example 

234759602834500

name (string)
Name of the Change Type

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

Example 

Sample Content

color (color)
Color code used to identify the change type in the application

color (color)
The color used to represent the entity.

Example 

#adf456

description (string)
A short description about the change type

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

Example 

Sample Content

inactive (boolean)
Indicates whether the change type is active or not

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

pre_approved (boolean)
Indicates whether the change type is Pre-approved or not

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

Add Change Type

This operation helps you Add change types. Mandatory Fields :- ,

Mandatory Fields :- [“name”,”color”]

Url

<service domain|custom domain>/app/<portal>/api/v3/change_types

Attributes

id (long)
Unique Identifier of Change type

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

Example 

234759602834500

name (string)
Name of the Change Type

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

Example 

Sample Content

color (color)
Color code used to identify the change type in the application

color (color)
The color used to represent the entity.

Example 

#adf456

description (string)
A short description about the change type

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

Example 

Sample Content

inactive (boolean)
Indicates whether the change type is active or not

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

pre_approved (boolean)
Indicates whether the change type is Pre-approved or not

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

$ curl <service domain|custom domain>/app/<portal>/api/v3/change_types\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_types";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
};
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/change_types"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}
'@
$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/change_types"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}'''
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_code": 2000,
    "status": "success"
  },
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1913389125112757"
  }
}

Edit Change Type

This operation helps you edit change types.

Url

<service domain|custom domain>/app/<portal>/api/v3/change_types/{change_type_id}

Attributes

id (long)
Unique Identifier of Change type

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

Example 

234759602834500

name (string)
Name of the Change Type

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

Example 

Sample Content

color (color)
Color code used to identify the change type in the application

color (color)
The color used to represent the entity.

Example 

#adf456

description (string)
A short description about the change type

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

Example 

Sample Content

inactive (boolean)
Indicates whether the change type is active or not

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

pre_approved (boolean)
Indicates whether the change type is Pre-approved or not

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

$ curl <service domain|custom domain>/app/<portal>/api/v3/change_types/{change_type_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/change_types/{change_type_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
};
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/change_types/{change_type_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}
'@
$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/change_types/{change_type_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description"
  }
}'''
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())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description",
    "id": "2145925944998875"
  }
}

Get Change Type

This operation helps you get change types.

Url

<service domain|custom domain>/app/<portal>/api/v3/change_types/{change_type_id}

Attributes

id (long)
Unique Identifier of Change type

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

Example 

234759602834500

name (string)
Name of the Change Type

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

Example 

Sample Content

color (color)
Color code used to identify the change type in the application

color (color)
The color used to represent the entity.

Example 

#adf456

description (string)
A short description about the change type

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

Example 

Sample Content

inactive (boolean)
Indicates whether the change type is active or not

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

pre_approved (boolean)
Indicates whether the change type is Pre-approved or not

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

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

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

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

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

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

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  },
  "change_type": {
    "inactive": false,
    "color": "#ffffff",
    "pre_approved": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1754216141205867"
  }
}

Get List Change Type

This operation helps you get list change types.

Url

<service domain|custom domain>/app/<portal>/api/v3/change_types

Attributes

id (long)
Unique Identifier of Change type

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

Example 

234759602834500

name (string)
Name of the Change Type

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

Example 

Sample Content

color (color)
Color code used to identify the change type in the application

color (color)
The color used to represent the entity.

Example 

#adf456

description (string)
A short description about the change type

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

Example 

Sample Content

inactive (boolean)
Indicates whether the change type is active or not

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

pre_approved (boolean)
Indicates whether the change type is Pre-approved or not

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

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

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

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

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

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

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "change_types": [
    {
      "inactive": false,
      "color": "#ffffff",
      "pre_approved": false,
      "name": "test-name",
      "description": "test-description",
      "id": "2146722921995413"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

Delete Change Type

This operation helps you delete change types.

Url

<service domain|custom domain>/app/<portal>/api/v3/change_types/{change_type_id}


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

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

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

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

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

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