Skip to content

Reason For Change

Reason for Change denotes the purpose of initiating a change request.

Attributes

id (long)
Unique Identifier for the Reason for change

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

Example

234759602834500

name (string)
Name of the Reason for change

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

Example

Sample Content

description (string)
A short description about the reason for change

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

Example

Sample Content

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

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

Add Reason For Change

This operation helps you add reasons for change. Mandatory field: name

Mandatory Fields :- name

Url

api/v3/reasons_for_change

Attributes

id (long)
Unique Identifier for the Reason for change

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

Example

234759602834500

name (string)
Name of the Reason for change

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

Example

Sample Content

description (string)
A short description about the reason for change

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

Example

Sample Content

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

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

$ curl <url>/api/v3/reasons_for_change\
      -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='{
  "reason_for_change": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'
// Deluge Sample script
url = "<url>/api/v3/reasons_for_change";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "reason_for_change": {
    "inactive": 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 = "<url>/api/v3/reasons_for_change"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "reason_for_change": {
    "inactive": 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 = "<url>/api/v3/reasons_for_change"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "reason_for_change": {
    "inactive": 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())
{
  "reason_for_change": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1587865199226293"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

Edit Reason For Change

This operation helps you edit reasons for change.

Url

api/v3/reasons_for_change/{reason_for_change_id}

Attributes

id (long)
Unique Identifier for the Reason for change

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

Example

234759602834500

name (string)
Name of the Reason for change

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

Example

Sample Content

description (string)
A short description about the reason for change

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

Example

Sample Content

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

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

$ curl <url>/api/v3/reasons_for_change/{reason_for_change_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='{
  "reason_for_change": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description"
  }
}'
// Deluge Sample script
url = "<url>/api/v3/reasons_for_change/{reason_for_change_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "reason_for_change": {
    "inactive": 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 = "<url>/api/v3/reasons_for_change/{reason_for_change_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "reason_for_change": {
    "inactive": 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 = "<url>/api/v3/reasons_for_change/{reason_for_change_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "reason_for_change": {
    "inactive": 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())
{
  "reason_for_change": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1549204711281784"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

Get Reason For Change

This operation helps you get reasons for change.

Url

api/v3/reasons_for_change/{reason_for_change_id}

Attributes

id (long)
Unique Identifier for the Reason for change

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

Example

234759602834500

name (string)
Name of the Reason for change

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

Example

Sample Content

description (string)
A short description about the reason for change

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

Example

Sample Content

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

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

$ curl -G <url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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())
{
  "reason_for_change": {
    "inactive": false,
    "name": "test-name",
    "description": "test-description",
    "id": "1643086306995826"
  },
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}

Get List Reason For Change

This operation helps you get list reasons for change.

Url

api/v3/reasons_for_change

Attributes

id (long)
Unique Identifier for the Reason for change

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

Example

234759602834500

name (string)
Name of the Reason for change

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

Example

Sample Content

description (string)
A short description about the reason for change

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

Example

Sample Content

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

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

$ curl -G <url>/api/v3/reasons_for_change\
      -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 = "<url>/api/v3/reasons_for_change";
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 = "<url>/api/v3/reasons_for_change"
$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 = "<url>/api/v3/reasons_for_change"
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"
    }
  ],
  "reasons_for_change": [
    {
      "inactive": false,
      "name": "test-name",
      "description": "test-description",
      "id": "1826181378917628"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

Delete Reason For Change

This operation helps you delete reasons for change.

Url

api/v3/reasons_for_change/{reason_for_change_id}

$ curl <url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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 = "<url>/api/v3/reasons_for_change/{reason_for_change_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"
  }
}