Endpoint
/api/v2/tenants/{tenantId}/changeRequests/{changeRequestId}/close
Path Parameters
tenantIdstring
changeRequestIdstring
notesstring
Additional information to add to a change request.
reasonstring
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
alertIdsarray
allowedStatusarray
Child Parameters
- allowedStatus.id
- allowedStatus.name
- allowedStatus.reasonsDefined
- allowedStatus.reasonsEnabled
applicationstring
Application from which the problem is generated.
assignedUserobject
Child Parameters
- assignedUser.email
- assignedUser.firstName
- assignedUser.id
- assignedUser.lastName
- assignedUser.loginName
- assignedUser.phoneNumber
assigneeGroupobject
Child Parameters
- assigneeGroup.description
- assigneeGroup.id
- assigneeGroup.name
- assigneeGroup.userCount
attachmentsarray
Child Parameters
- attachments.contentURL
- attachments.createdDate
- attachments.file
- attachments.id
- attachments.name
ccstring
Cc email.
channelIdinteger
clientobject
Child Parameters
- client.activated
- client.createdTime
- client.id
- client.name
- client.uniqueId
- client.updatedTime
closedDatestring
closedSummarystring
createdDatestring
createdUserobject
Child Parameters
- createdUser.email
- createdUser.firstName
- createdUser.id
- createdUser.lastName
- createdUser.loginName
- createdUser.phoneNumber
customFieldsarray
Child Parameters
- 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
descriptionstring
Description of the problem.
estimatedHoursinteger
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".
estimatedMinutesinteger
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".
extTicketIdstring
Attach an external ticket ID to the problem.
idstring
knowledgeArticleIdsarray
(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.
Child Parameters
knownIssueboolean
notesstring
oldPrioritystring
oldStatusstring
prioritystring
Priority of the problem.
priorityUpdatedByobject
Child Parameters
- priorityUpdatedBy.email
- priorityUpdatedBy.firstName
- priorityUpdatedBy.id
- priorityUpdatedBy.lastName
- priorityUpdatedBy.loginName
- priorityUpdatedBy.phoneNumber
priorityUpdatedDatestring
reOpenCountinteger
reasonstring
requesterobject
Child Parameters
- requester.email
- requester.firstName
- requester.id
- requester.lastName
- requester.loginName
- requester.phoneNumber
resolvedDatestring
resourcesarray
Child Parameters
- resources.aliasName
- resources.hostName
- resources.id
- resources.metaData
- resources.name
- resources.resourceName
- resources.resourceType
- resources.type
rootCausestring
Root cause of the problem.
slaDetailsobject
Child Parameters
- slaDetails.resolutionBreach
- slaDetails.resolutionBreachDate
- slaDetails.resolutionTime
- slaDetails.responseBreach
- slaDetails.responseBreachDate
- slaDetails.responseTime
- slaDetails.slaPolicy
sourcestring
statusstring
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".
statusFlowarray
Child Parameters
- statusFlow.createdDate
- statusFlow.notes
- statusFlow.reason
- statusFlow.status
- statusFlow.timeSpent
- statusFlow.updatedBy
statusUpdatedByobject
Child Parameters
- statusUpdatedBy.email
- statusUpdatedBy.firstName
- statusUpdatedBy.id
- statusUpdatedBy.lastName
- statusUpdatedBy.loginName
- statusUpdatedBy.phoneNumber
statusUpdatedDatestring
subjectstring
Subject of the problem.
suspendEndDatestring
tagsstring
ticketArisedTimestring
timeSpentinteger
updatedDatestring
workaroundstring
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"
}