Releases

Getting a list of all releases

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

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

Getting release details (using release ID number):

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

Create a new release:

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/releases.xml

Required fields:

<name>,<requester>,<state>

XML Example:

<release>
  <name>Release title</name>
  <state>Open</state>
  <priority>Medium</priority>
  <description>Release description</description>
  <requester><email>demo@samanage.com</email></requester>
  <approvers type="array">
<approver><email>demo@samanage.com</email></approver>
  </approvers>
  <assignee><email>demo@samanage.com</email></assignee>
  <plan>Release plan</plan>
  <build>Release build</build>
  <deploy>Release deploy</deploy>
  <planned_end_at>Dec 11, 2012</planned_end_at>
  <planned_start_at>Dec 12, 2012</planned_start_at>
  <site><name>Site name</name></site>
  <department><name>Department name</name></department>
  <changes type="array">
    <change><number>27</number></change>
  </changes>
  <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>
</release>

JSON Exmaple:

{
    "release": {
    "name": "Release Title",
    "state": "Open",
    "priority": "Medium",
    "description": "Release description",
    "requester": {"email": "demo@samanage.com"},
       "approval_levels": [
          "approval_level": {
            "approval_condition": APPR_COND,
            "Approvers":{
               "Approver": [ 
                   {"email": "demo@samanage.com"},{"email": "user@samanage.com"}
               ]
            }
          }
       ],
    "assignee": {"email": "demo@samanage.com"},
    "plan": "Release plan",
    "build": "Release build",
    "deploy": "Release deploy",
    "planned_end_at": "Dec 11, 2012",
    "planned_start_at": "Dec 1, 2012",
    "site": {"name": "Site Name"},
"department": {"name": "Department Name"},
"changes":{
    "change": [{"number": 27}, {"number": 45}]
    },
    "custom_fields_values":{
    "custom_fields_value":[
{"name": "Custom Field Name 1", "value": "Value 1"},
{"name": "Custom Field Name 2", "value": "Value 2"},
{"name": "Custom Field Name 3", "value": "Value 3"}]
}
}
}

Available values for fields:

• approval_condition:

  • 0, no approvers required

  • 1, only one approver required

  • 2, all approvers required

  • 3, 50% of approvers required