Documentation forSolarWinds Service Desk


Getting a list of all releases

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

Getting release details (using release ID number):

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

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

Required fields:


XML Example:


  <name>Release title</name>



  <description>Release description</description>


  <approvers type="array">




  <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">





      <name>field name</name>




      <name>field name</name>





JSON Exmaple:


    "release": {

    "name": "Release Title",

    "state": "Open",

    "priority": "Medium",

    "description": "Release description",

    "requester": {"email": ""},

       "approval_levels": [

          "approval_level": {

            "approval_condition": APPR_COND,


               "Approver": [

                   {"email": ""},{"email": ""}





    "assignee": {"email": ""},

    "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"},


    "change": [{"number": 27}, {"number": 45}]




{"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