Changes

Getting a list of all changes

curl -H "X-Samanage-Authorization: Bearer TOKEN" -H 'Accept: application/vnd.samanage.v2.1+xml' -X GET

https://api.samanage.com/changes.xml

Getting change details (using change’s ID number):

curl -H "X-Samanage-Authorization: Bearer TOKEN" -H 'Accept: application/vnd.samanage.v2.1+xml' -X GET https://api.samanage.com/changes/CHANGE_ID.xml

Create a new change:

curl -H "X-Samanage-Authorization: Bearer TOKEN" -d 'INPUT_XML' -H 'Accept: application/xml' -H 'Content-Type:text/xml' -X POST https://api.samanage.com/changes.xml

Required fields:

<name>,<requester>,<state>,<priority>

Optional fields:

<description>,<assignee>,<change_plan>,<rollback_plan>,

<rollback_plan>,<test_plan>,<planned_start_at>,<planned_end_at>,<site>,<department>,<release>,<problems>

XML Example:

<change>
  <name>Change title</name>
  <requester><email>demo@samanage.com</email></requester>
  <state>On_Hold</state>
  <description>Change description</description>
  <priority>Medium</priority>
  <assignee><email>demo@samanage.com</email></assignee>
  <change_plan>Change Plan</change_plan>
  <rollback_plan>Rollback plan</rollback_plan>
  <test_plan>Test Plan</test_plan>
  <planned_start_at>Dec 11, 2012</planned_start_at>
  <planned_end_at>Dec 12, 2012</planned_end_at>
  <site><name>Site name</name></site>
  <department><name>Department name</name></department>
  <release><number>14</number></release>
  <problems type="array">
    <problem><number>445</number></problem>
  </problems>
  <custom_fields_values>
    <custom_fields_value>
      <name>field name</name>
      <value>content</value>
    </custom_fields_value>
    <custom_fields_value>
      <name>field name</name>
      <value>content</value>
    </custom_fields_value>
  </custom_fields_values>
</change>

JSON Example:

{
  "change":{
    "name":"change title",
    "requester":{"email":"demo@samanage.com"}, 
    "state":"On hold",
    "description":"change description",
    "priority":"Medium",
    "assignee":{"email":"demo@samanage.com"},
    "change_plan":"change plan",
    "rollback_plan":"rollback plan",
    "test_plan":"test plan",
    "planned_start_at":"dec 12,2015",
    "planned_end_at":"dec 12,2015",
    "site":{"name":"site name"},
    "department":{"name":"department name"},
    "release":{"number":"14"},
    "problems":{"problem":[{"number":"445"}]},
    "custom_fields_values":{
      "custom_fields_value":[
      {"name":"field_name","value":"content"},
      {"name":"field_name","value":"content"}]
    }
  }
}
  "change":{
    "name":"change title",
    "Requester":{"email":"demo@samanage.com"},She truly 
    "state":"On hold",
    "description":"change description",
    "priority":"Medium",
    "assignee":{"email":"demo@samanage.com"},
    "change_plan":"change plan",
    "rollback_plan":"rollback plan",
    "test_plan":"test plan",
    "planned_start_at":"dec 12,2015",
    "planned_end_at":"dec 12,2015",
    "site":{"name":"site name"},
    "department":{"name":"department name"},
    "release":{"number":"14"},
    "problems":{"problem":[{"number":"445"}]},
    "custom_fields_values":{
      "custom_fields_value":[
      {"name":"field_name","value":"content"},
      {"name":"field_name","value":"content"}]
    }
  }
}

Updating a change:

curl -H "X-Samanage-Authorization: Bearer TOKEN" -d 'INPUT_XML' -H 'Accept: application/xml' -H 'Content-Type:text/xml' -X PUT https://api.samanage.com/changes/CHANGE_ID.xml

XML Example:

<change>
  <field_to_update>content</field_to_update>
</change>

JSON Example:

{
  "change":{
    "field_to_update":"content"
  }
}