Endpoint
/api/v2/tenants/{tenantId}/changeRequests/{changeRequestId}/close
Path Parameters
tenantId
string

changeRequestId
string

notes
string

Additional information to add to a change request.

reason
string

Reason for closing the change request. This is mandatory only if the option Enable reasons to change status Close is enabled for change request in service desk settings (See example steps).

{
  "notes": "Demo note on change request",
  "reason": "Request is implemented"
}

Responses

OK

alertIds
array

allowedStatus
array

allowedStatus.id
allowedStatus.name
allowedStatus.reasonsDefined
allowedStatus.reasonsEnabled
application
string

Application from which the problem is generated.

assignedUser
object

assignedUser.email
assignedUser.firstName
assignedUser.id
assignedUser.lastName
assignedUser.loginName
assignedUser.phoneNumber
assigneeGroup
object

assigneeGroup.description
assigneeGroup.id
assigneeGroup.name
assigneeGroup.userCount
attachedArticles
array

attachedArticles.id
attachedArticles.subject
attachments
array

attachments.contentURL
attachments.createdDate
attachments.file
attachments.id
attachments.name
category
object

category.id
category.name
cc
string

Cc email.

changeRequest
object

Attach a problem related to the problem.

changeRequest.id
channelId
integer

client
object

client.activated
client.createdTime
client.id
client.name
client.uniqueId
client.updatedTime
closedDate
string

closedSummary
string

createdDate
string

createdUser
object

createdUser.email
createdUser.firstName
createdUser.id
createdUser.lastName
createdUser.loginName
createdUser.phoneNumber
customFields
array

customFields.classCode
customFields.customField
customFields.defaultValue
customFields.description
customFields.displayLabel
customFields.editable
customFields.fieldType
customFields.id
customFields.mandatory
customFields.name
customFields.options
customFields.selectedOption
customFields.value
description
string

Description of the problem.

estimatedHours
integer

Estimated time for resolving a problem. For example, a user estimates 3 hours for completion of a problem, the user provides value as "estimatedHours": "3".

estimatedMinutes
integer

Estimated time for resolving a problem. For example, a user estimates 45 minutes for completion of a task, then user provides value as "estimatedMinutes": "45".

extTicketId
string

Attach an external ticket ID to the problem.

id
string

knowledgeArticleIds
array

(Optional) Attach knowledge base articles related to the problem for further reference. To get a knowledge base article ID: 1. Log into OpsRamp. 2. Click Knowledge Base. 3. Select the required article and then copy the article ID. 4. Provide the article ID in "knowledgeArticleIds" field. Example: "knowledgeArticleIds": 25, 16.

knownIssue
boolean

notes
string

oldPriority
string

oldStatus
string

priority
string

Priority of the problem.

priorityUpdatedBy
object

priorityUpdatedBy.email
priorityUpdatedBy.firstName
priorityUpdatedBy.id
priorityUpdatedBy.lastName
priorityUpdatedBy.loginName
priorityUpdatedBy.phoneNumber
priorityUpdatedDate
string

reOpenCount
integer

reason
string

requester
object

requester.email
requester.firstName
requester.id
requester.lastName
requester.loginName
requester.phoneNumber
resolvedDate
string

resources
array

resources.aliasName
resources.hostName
resources.id
resources.metaData
resources.name
resources.resourceName
resources.resourceType
resources.type
rootCause
string

Root cause of the problem.

slaDetails
object

slaDetails.resolutionBreach
slaDetails.resolutionBreachDate
slaDetails.resolutionTime
slaDetails.responseBreach
slaDetails.responseBreachDate
slaDetails.responseTime
slaDetails.slaPolicy
source
string

status
string

Status of problem. Follow the steps to update the status of problem: 1. Use the get problem API to check: 2. Status flow transitions of problem.The status flows are defined in the field allowedStatus. Example: "name" : "Update" 3. Option to provide reasons to change the status is enabled."reasonsEnabled" : "true" indicates, reason is mandatory while changing the status."reasonsEnabled" : "false" indicates reason is optional. 4. If status change reasons are defined, use the get status change reasons to get the list of reasons. Provide the reasons configured in status "Update".

statusFlow
array

statusFlow.createdDate
statusFlow.notes
statusFlow.reason
statusFlow.status
statusFlow.timeSpent
statusFlow.updatedBy
statusUpdatedBy
object

statusUpdatedBy.email
statusUpdatedBy.firstName
statusUpdatedBy.id
statusUpdatedBy.lastName
statusUpdatedBy.loginName
statusUpdatedBy.phoneNumber
statusUpdatedDate
string

subCategory
object

subCategory.id
subCategory.name
subject
string

Subject of the problem.

suspendEndDate
string

tags
string

ticketArisedTime
string

timeSpent
integer

updatedDate
string

workaround
string

Temporary solution to solve the problem.

{
  "alertIds": [],
  "allowedStatus": [],
  "assignedUser": {
    "email": "sample@opsramp.com",
    "firstName": "Brocade",
    "id": "USR0000000013",
    "lastName": "Inc PAdmin",
    "loginName": "brocadePAdmin@opsramp.com",
    "phoneNumber": "8096250653"
  },
  "assigneeGroup": {
    "description": "Brocade Partner Users",
    "id": 5,
    "name": "Brocade Inc Users"
  },
  "category": {
    "id": 6,
    "name": "Request Level"
  },
  "cc": "sample@opsramp.com",
  "client": {
    "activated": true,
    "id": 8,
    "name": "Brocade Lab",
    "uniqueId": "client_8"
  },
  "closedDate": "2016-11-25T09:48:42+0530",
  "closedSummary": "closed summary",
  "createdDate": "2016-07-26T20:13:45+0530",
  "createdUser": {
    "email": "sample@opsramp.com",
    "firstName": "Ops Admin",
    "lastName": " ",
    "loginName": "ops_admin_user"
  },
  "customFields": [
    {
      "classCode": "CHANGE",
      "defaultValue": "",
      "description": "all partners",
      "displayLabel": "text field",
      "editable": true,
      "fieldType": "TYPE_TEXT",
      "id": "UDF0000003808",
      "mandatory": false,
      "name": "text_field_3808"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "",
      "description": "testing all partners",
      "displayLabel": "drop down",
      "editable": true,
      "fieldType": "TYPE_DROPDOWN",
      "id": "UDF0000003809",
      "mandatory": false,
      "name": "drop_down_3809",
      "options": [
        {
          "label": "one",
          "value": "1"
        },
        {
          "label": "two",
          "value": "2"
        }
      ]
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "",
      "description": "testing numeric",
      "displayLabel": "numeric",
      "editable": true,
      "fieldType": "TYPE_NUMBER",
      "id": "UDF0000003810",
      "mandatory": false,
      "name": "numeric_3810"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "",
      "description": "Test case",
      "displayLabel": "drop-down-api-lab",
      "editable": true,
      "fieldType": "TYPE_DROPDOWN",
      "id": "UDF0000003790",
      "mandatory": false,
      "name": "drop_down_api_lab_3790",
      "options": [
        {
          "label": "first",
          "value": "1"
        },
        {
          "label": "second",
          "value": "2"
        }
      ],
      "selectedOption": {
        "label": "first",
        "value": "1"
      },
      "value": "1"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "Test Text",
      "description": "test case for text field",
      "displayLabel": "text-api-lab",
      "editable": true,
      "fieldType": "TYPE_TEXT",
      "id": "UDF0000003791",
      "mandatory": false,
      "name": "text_api_lab_3791",
      "value": "request custom field - text-updated"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "multi \nline \ntext",
      "description": "test case for multi line text",
      "displayLabel": "multi line text-api-lab",
      "editable": true,
      "fieldType": "TYPE_TEXTAREA",
      "id": "UDF0000003792",
      "mandatory": false,
      "name": "multi_line_text_api_lab_3792"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "1",
      "description": "numeric test case",
      "displayLabel": "Numeric-api-lab",
      "editable": true,
      "fieldType": "TYPE_NUMBER",
      "id": "UDF0000003793",
      "mandatory": false,
      "name": "numeric_api_lab_3793"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "0",
      "description": "test case for check box",
      "displayLabel": "checkbox-api-lab",
      "editable": true,
      "fieldType": "TYPE_CHECKBOX",
      "id": "UDF0000003794",
      "mandatory": false,
      "name": "checkbox_api_lab_3794",
      "options": [
        {
          "label": "yes",
          "value": "1"
        }
      ]
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "2016-02-26T12:13:00+0000",
      "description": "test case for date field",
      "displayLabel": "Date-ap-lab",
      "editable": true,
      "fieldType": "TYPE_DATE",
      "id": "UDF0000003795",
      "mandatory": false,
      "name": "date_ap_lab_3795"
    },
    {
      "classCode": "CHANGE",
      "defaultValue": "2016-02-26T12:13:00+0000",
      "description": "test case for Date and time",
      "displayLabel": "dateTime-api-lab",
      "editable": true,
      "fieldType": "TYPE_DATETIME",
      "id": "UDF0000003796",
      "mandatory": false,
      "name": "datetime_api_lab_3796"
    }
  ],
  "description": "Internet very slow in SJ office, and servers not accessible",
  "id": "CHG0000000222",
  "notes": "Demo note on change request",
  "oldPriority": "Normal",
  "oldStatus": "Open",
  "priority": "High",
  "priorityUpdatedBy": {
    "email": "sample@opsramp.com",
    "firstName": "john",
    "lastName": "smith",
    "loginName": "john.smith",
    "phoneNumber": "9985597783"
  },
  "priorityUpdatedDate": "2016-08-12T06:56:51+0530",
  "reOpenCount": 0,
  "reason": "CR Close",
  "requester": {
    "email": "sample@opsramp.com",
    "firstName": "Ops Admin",
    "lastName": " ",
    "loginName": "ops_admin_user"
  },
  "resolvedDate": "2016-08-12T06:57:46+0530",
  "resources": [
    {
      "id": "ad0a218d-7512-435c-9b58-614470ee8658",
      "name": "WORK-PC",
      "type": "DEVICE"
    },
    {
      "id": "SGP-c2af3866-fc89-47dd-b83f-bcc8df0b2a0a",
      "name": "VTH Services",
      "type": "SERVICE"
    },
    {
      "id": "DGP-420a80f4-5fba-46d5-a1c1-20e2df4a326a",
      "name": "HYD",
      "type": "DEVICE_GROUP"
    }
  ],
  "slaDetails": {
    "resolutionBreach": false,
    "resolutionBreachDate": "",
    "resolutionTime": 1440930,
    "responseBreach": false,
    "responseBreachDate": "",
    "responseTime": 1440840
  },
  "source": "INTEGRATION",
  "status": "Closed",
  "statusFlow": [
    {
      "createdDate": "2016-07-26T20:13:45+0530",
      "status": "New",
      "timeSpent": 1440729,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "Ops Admin",
        "lastName": " ",
        "loginName": "ops_admin_user"
      }
    },
    {
      "createdDate": "2016-08-12T12:25:54+0530",
      "reason": "CR Open",
      "status": "Open",
      "timeSpent": 96,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "john",
        "lastName": "smith",
        "loginName": "john.smith",
        "phoneNumber": "9985597783"
      }
    },
    {
      "createdDate": "2016-08-12T12:27:30+0530",
      "reason": "CR Pending",
      "status": "Pending",
      "timeSpent": 5,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "john",
        "lastName": "smith",
        "loginName": "john.smith",
        "phoneNumber": "9985597783"
      }
    },
    {
      "createdDate": "2016-08-12T12:27:35+0530",
      "reason": "CR Open",
      "status": "Open",
      "timeSpent": 11,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "john",
        "lastName": "smith",
        "loginName": "john.smith",
        "phoneNumber": "9985597783"
      }
    },
    {
      "createdDate": "2016-08-12T12:27:46+0530",
      "reason": "CR Resolved",
      "status": "Resolved",
      "timeSpent": 12,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "john",
        "lastName": "smith",
        "loginName": "john.smith",
        "phoneNumber": "9985597783"
      }
    },
    {
      "createdDate": "2016-08-12T12:27:58+0530",
      "reason": "CR Onhold",
      "status": "On Hold",
      "timeSpent": 9062350,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "john",
        "lastName": "smith",
        "loginName": "john.smith",
        "phoneNumber": "9985597783"
      }
    },
    {
      "createdDate": "2016-11-25T09:47:08+0530",
      "notes": "Resolved",
      "reason": "CR Open",
      "status": "Open",
      "timeSpent": 94,
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "SP",
        "id": "USR0000000018",
        "lastName": "Admin",
        "loginName": "superadmin"
      }
    },
    {
      "createdDate": "2016-11-25T09:48:42+0530",
      "notes": "Demo note on change request",
      "reason": "Request is implemented",
      "status": "Closed",
      "updatedBy": {
        "email": "sample@opsramp.com",
        "firstName": "Ops Admin",
        "lastName": " ",
        "loginName": "ops_admin_user"
      }
    }
  ],
  "statusUpdatedBy": {
    "email": "sample@opsramp.com",
    "firstName": "Ops Admin",
    "lastName": " ",
    "loginName": "ops_admin_user"
  },
  "statusUpdatedDate": "2016-11-25T09:48:42+0530",
  "subCategory": {
    "id": 8,
    "name": "Low"
  },
  "subject": "Increase bandwidth of internet",
  "suspendEndDate": "2016-08-23T03:57:00+0530",
  "ticketArisedTime": "",
  "updatedDate": "2016-11-25T09:48:42+0530"
}