Endpoint
/api/v2/tenants/{tenantId}/incidents/{incidentId}
Gets the details of an incident.
Path Parameters
tenantIdstring
incidentIdstring
Responses
OK
alertIdsarray
allowedStatusarray
Child Parameters
- allowedStatus.id
- allowedStatus.name
- allowedStatus.reasonsDefined
- allowedStatus.reasonsEnabled
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
attachedRequestsarray
Attach service requests to an incident. Use the search service requests to get list of service requests in a client.
Child Parameters
- attachedRequests.id
attachmentsarray
Attach files related to the change request. Convert attachment files to byte stream with base64-encoding. The file size limit of an attachment is 50 MB.
Child Parameters
- attachments.file
- attachments.name
businessImpactobject
Child Parameters
- businessImpact.createdBy
- businessImpact.createdDate
- businessImpact.description
- (Optional) Short summary describing the business impact.
- businessImpact.name
- Business impact name.
- businessImpact.uniqueId
- businessImpact.updatedBy
- businessImpact.updatedDate
categoryobject
Add the change request under a category. Use the get API to get the list of categories.
Child Parameters
- category.id
ccstring
Cc email.
changePlanstring
Description of the change plan.
changeRequestobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- changeRequest.id
changeTypestring
Normal or Emergency depending on the Priority of a change request. For example, create a change type Emergency for change requests that must be processed immediately or if Priority of a request is High.
channelIdstring
clientobject
Child Parameters
- client.activated
- client.createdTime
- client.id
- client.name
- client.uniqueId
- client.updatedTime
closedSummarystring
consolesarray
Child Parameters
- consoles.consoleProtocol
- Console protocol.
- consoles.options
- Console options.
- consoles.type
- Console type
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
Ticket description.
dueDatestring
extTicketIdstring
Attach third party ticket ID.
idstring
knowledgeArticleIdsarray
Attach knowledge base articles related to the change request 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
locationstring
notesstring
oldPrioritystring
oldStatusstring
parentIdstring
Attach incident. Provide the incident ID as an attachment.
plannedEndstring
plannedStartstring
policyobject
Child Parameters
- policy.active
- policy.createdDate
- policy.executionOrder
- policy.id
- policy.name
- policy.policyType
- policy.updatedDate
prioritystring
Ticket priority with supported priority values: Low, Normal, High, Urgent, and Very Low.
priorityUpdatedByobject
Child Parameters
- priorityUpdatedBy.email
- priorityUpdatedBy.firstName
- priorityUpdatedBy.id
- priorityUpdatedBy.lastName
- priorityUpdatedBy.loginName
- priorityUpdatedBy.phoneNumber
priorityUpdatedDatestring
problemobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- problem.id
reOpenCountinteger
requesterobject
Child Parameters
- requester.email
- requester.firstName
- requester.id
- requester.lastName
- requester.loginName
- requester.phoneNumber
resolutionSummarystring
resolveDatestring
resourcesarray
Child Parameters
- resources.aliasName
- resources.hostName
- resources.id
- resources.metaData
- resources.name
- resources.resourceName
- resources.resourceType
- resources.type
rollbackPlanstring
Description of roll back plan.
scheduleobject
Child Parameters
- schedule.endTime
- Schedule end time.
- schedule.pattern
- Recurrence pattern.
- schedule.startTime
- Schedule start time.
- schedule.timezone
- Schedule time zone. The list of timezones are shown below. Example: "timezone": "America/Los_Angeles"
- schedule.type
- Schedule type.
serviceRestoreDatestring
slaDetailsobject
Child Parameters
- slaDetails.resolutionBreach
- slaDetails.resolutionBreachDate
- slaDetails.resolutionTime
- slaDetails.responseBreach
- slaDetails.responseBreachDate
- slaDetails.responseTime
- slaDetails.slaPolicy
sourcestring
sourceEntityTypestring
sourceEntityTypeIdstring
sourcePolicyTypestring
sourcePolicyTypeIdstring
statusstring
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
subCategoryobject
Add the change request under a sub-category. Use get categories to get the list of sub-categories.
Child Parameters
- subCategory.id
subjectstring
Ticket subject.
tagsstring
testPlanstring
Description of test plan.
ticketArisedTimestring
toEmailstring
Email address of the user. An email notification is sent to the user.
updatedDatestring
workEndstring
workStartstring
{
"alertIds": [
100
],
"allowedStatus": [
{
"id": "1",
"name": "New",
"reasonsDefined": false,
"reasonsEnabled": false
},
{
"id": "2",
"name": "Open",
"reasonsDefined": true,
"reasonsEnabled": true
},
{
"id": "3",
"name": "Pending",
"reasonsDefined": true,
"reasonsEnabled": true
},
{
"id": "5",
"name": "Closed",
"reasonsDefined": true,
"reasonsEnabled": true
},
{
"id": "6",
"name": "On Hold",
"reasonsDefined": true,
"reasonsEnabled": true
}
],
"assignedUser": {
"email": "brocadeLab@gmail.com",
"firstName": "Brocade",
"id": "USR0000000014",
"lastName": "Lab",
"loginName": "brocadeLab@organization.com"
},
"assigneeGroup": {
"description": "Brocade Partner Users",
"id": 5,
"name": "Brocade Inc Users"
},
"attachedArticles": [
{
"id": 25,
"subject": "Network Troubleshooting"
},
{
"id": 16,
"subject": "LAN Settings"
}
],
"attachedRequests": [
{
"id": "SRQ0000001388"
},
{
"id": "SRQ0000001391"
},
{
"id": "SRQ0000001394"
},
{
"id": "SRQ0000001397"
}
],
"businessImpact": {
"description": "Impact level 2",
"id": 10,
"name": "Impact 2"
},
"category": {
"id": 1,
"name": "Urgency"
},
"cc": "brocade@gmail.com, escalationmails@gmail.com",
"client": {
"activated": true,
"id": 8,
"name": "Brocade Lab",
"uniqueId": "client_8"
},
"createdDate": "2016-07-25T07:12:19+0000",
"createdUser": {
"email": "john.smith@gmail.com",
"firstName": "John",
"lastName": "Smith",
"loginName": "john.smith"
},
"customFields": [
{
"classCode": "INCIDENT",
"defaultValue": "",
"description": "All partners",
"displayLabel": "text field",
"editable": true,
"fieldType": "TYPE_TEXT",
"id": "UDF0000003808",
"mandatory": false,
"name": "text_field_3808",
"value": "available"
},
{
"classCode": "INCIDENT",
"defaultValue": "",
"description": "Testing numeric",
"displayLabel": "numeric",
"editable": true,
"fieldType": "TYPE_NUMBER",
"id": "UDF0000003810",
"mandatory": false,
"name": "numeric_3810",
"value": "120"
},
{
"classCode": "INCIDENT",
"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": "INCIDENT",
"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": "INCIDENT",
"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",
"value": "text"
},
{
"classCode": "INCIDENT",
"defaultValue": "1",
"description": "numeric test case",
"displayLabel": "Numeric-api-lab",
"editable": true,
"fieldType": "TYPE_NUMBER",
"id": "UDF0000003793",
"mandatory": false,
"name": "numeric_api_lab_3793",
"value": "1"
},
{
"classCode": "INCIDENT",
"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"
}
],
"selectedOption": {
"label": "yes",
"value": "1"
},
"value": "1"
},
{
"classCode": "INCIDENT",
"defaultValue": "2016-02-26T00:00: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",
"value": "2016-02-26T00:00:00+0000"
},
{
"classCode": "INCIDENT",
"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",
"value": "2016-02-26T12:13:00+0000"
}
],
"description": "Network appears to be down. Unable to access internet and key applications.",
"dueDate": "2016-08-17T13:51:00+0000",
"extTicketId": "000042526342",
"id": "INC0000001114",
"knowledgeArticleIds": [
25,
16
],
"notes": "",
"oldPriority": "Low",
"oldStatus": "Open",
"policy": {
"active": true,
"createdDate": "2016-07-24T09:02:38+0000",
"executionOrder": 2,
"id": 21,
"name": "All Alert Auto Incidents",
"policyType": "AUTO_INCIDENT_TO_ALERT",
"updatedDate": "2016-07-25T16:50:49+0000"
},
"priority": "High",
"priorityUpdatedBy": {
"email": "johns.smith@gmail.com",
"firstName": "John",
"lastName": "Smith",
"loginName": "john.smith"
},
"priorityUpdatedDate": "2016-07-25T07:12:19+0000",
"reOpenCount": 1,
"reason": "Issue got fixed, hence moving to resolved",
"requester": {
"email": "john.smith@gmail.com",
"firstName": "John",
"lastName": "Smith",
"loginName": "john.smith"
},
"resolutionSummary": "",
"resolvedDate": "2016-08-11T13:50:18+0000",
"resources": [
{
"aliasName": "",
"hostName": "VMtest",
"id": "481af404-33a6-4d61-af77-c483ca6641fa",
"metaData": {},
"name": "VMtest",
"resourceName": "",
"resourceType": "VMWAREHOST",
"type": "VMWAREHOST"
},
{
"aliasName": "",
"hostName": "CREDtest",
"id": "402c0d1a-bb31-4f02-b214-39433d23b922",
"metaData": {},
"name": "CREDtest",
"resourceName": "",
"resourceType": "Android",
"type": "Android"
},
{
"aliasName": "TestAlias",
"hostName": "TestHost",
"id": "61fec02a-4370-4dfb-be4d-1bb9fe3e05aa",
"metaData": {},
"name": "TestHost",
"resourceName": "TestResource",
"resourceType": "Desktop",
"type": "Desktop"
}
],
"serviceRestoreDate": "2016-08-17T13:51:00+0000",
"slaDetails": {
"resolutionBreach": false,
"resolutionBreachDate": "2016-07-25T09:12:19+0000",
"resolutionTime": 491861,
"responseBreach": false,
"responseBreachDate": "2016-07-25T08:12:19+0000",
"responseTime": 491834,
"slaPolicy": {
"businessSchedule": {
"endTime": "20:00:00",
"friday": true,
"id": 0,
"monday": true,
"saturday": false,
"shiftType": 0,
"startTime": "10:00:00",
"sunday": false,
"thursday": true,
"tuesday": true,
"wednesday": true
},
"id": 6,
"name": "P4_INCIDENT_SLA",
"timezone": {
"code": "IST",
"id": "19",
"label": "GMT +05:30 India",
"name": "GMT"
}
}
},
"source": "PORTAL",
"sourceEntityType": "ALERT",
"sourceEntityTypeId": "100",
"sourcePolicyType": "AUTOINCIDENT",
"sourcePolicyTypeId": "21",
"status": "Resolved",
"statusFlow": [
{
"createdDate": "2016-07-25T12:42:19+0000",
"status": "New",
"timeSpent": 1492634,
"updatedBy": {
"email": "john.smith@gmail.com",
"firstName": "John",
"lastName": "Smith",
"loginName": "john.smith"
}
},
{
"createdDate": "2016-08-11T19:19:33+0000",
"notes": "resolution summary",
"reason": "Resolving as fixed",
"status": "Resolved",
"timeSpent": 18,
"updatedBy": {
"email": "john@gmail.com",
"firstName": "john",
"lastName": "smith",
"loginName": "john.smith"
}
},
{
"createdDate": "2016-08-11T19:19:51+0000",
"reason": "Re-opening as per comments",
"status": "Open",
"timeSpent": 27,
"updatedBy": {
"email": "john@gmail.com",
"firstName": "john",
"lastName": "smith",
"loginName": "john.smith"
}
},
{
"createdDate": "2016-08-11T13:50:18+0000",
"notes": "resolution summary",
"reason": "Problem identified and fixed",
"status": "Resolved",
"updatedBy": {
"email": "sample@gmail.com",
"firstName": "SP",
"id": "USR0000000018",
"lastName": "Admin",
"loginName": "superadmin"
}
}
],
"statusUpdatedBy": {
"email": "escalationmails@gmail.com",
"firstName": "SA",
"lastName": "Admin",
"loginName": "superadmin"
},
"statusUpdatedDate": "2016-08-11T13:50:18+0000",
"subCategory": {
"id": 4,
"name": "P1"
},
"subject": "Issue with LAN in West-CA office",
"ticketArisedTime": "",
"toEmail": "escalationmails@gmail.com",
"updatedDate": "2016-08-11T13:50:18+0000",
"urgency": {
"description": "Urgency level 1",
"id": 25,
"name": "Urgency 1"
}
}
Endpoint
/api/v2/tenants/{tenantId}/incidents/{incidentId}
Updates an incident.
Path Parameters
tenantIdstring
incidentIdstring
alertIdsarray
allowedStatusarray
Child Parameters
- allowedStatus.id
- allowedStatus.name
- allowedStatus.reasonsDefined
- allowedStatus.reasonsEnabled
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
attachedRequestsarray
Attach service requests to an incident. Use the search service requests to get list of service requests in a client.
Child Parameters
- attachedRequests.id
attachmentsarray
Attach files related to the change request. Convert attachment files to byte stream with base64-encoding. The file size limit of an attachment is 50 MB.
Child Parameters
- attachments.file
- attachments.name
businessImpactobject
Child Parameters
- businessImpact.createdBy
- businessImpact.createdDate
- businessImpact.description
- (Optional) Short summary describing the business impact.
- businessImpact.name
- Business impact name.
- businessImpact.uniqueId
- businessImpact.updatedBy
- businessImpact.updatedDate
categoryobject
Add the change request under a category. Use the get API to get the list of categories.
Child Parameters
- category.id
ccstring
Cc email.
changePlanstring
Description of the change plan.
changeRequestobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- changeRequest.id
changeTypestring
Normal or Emergency depending on the Priority of a change request. For example, create a change type Emergency for change requests that must be processed immediately or if Priority of a request is High.
channelIdstring
clientobject
Child Parameters
- client.activated
- client.createdTime
- client.id
- client.name
- client.uniqueId
- client.updatedTime
closedSummarystring
consolesarray
Child Parameters
- consoles.consoleProtocol
- Console protocol.
- consoles.options
- Console options.
- consoles.type
- Console type
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
Ticket description.
dueDatestring
extTicketIdstring
Attach third party ticket ID.
idstring
knowledgeArticleIdsarray
Attach knowledge base articles related to the change request 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
locationstring
notesstring
oldPrioritystring
oldStatusstring
parentIdstring
Attach incident. Provide the incident ID as an attachment.
plannedEndstring
plannedStartstring
policyobject
Child Parameters
- policy.active
- policy.createdDate
- policy.executionOrder
- policy.id
- policy.name
- policy.policyType
- policy.updatedDate
prioritystring
Ticket priority with supported priority values: Low, Normal, High, Urgent, and Very Low.
priorityUpdatedByobject
Child Parameters
- priorityUpdatedBy.email
- priorityUpdatedBy.firstName
- priorityUpdatedBy.id
- priorityUpdatedBy.lastName
- priorityUpdatedBy.loginName
- priorityUpdatedBy.phoneNumber
priorityUpdatedDatestring
problemobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- problem.id
reOpenCountinteger
requesterobject
Child Parameters
- requester.email
- requester.firstName
- requester.id
- requester.lastName
- requester.loginName
- requester.phoneNumber
resolutionSummarystring
resolveDatestring
resourcesarray
Child Parameters
- resources.aliasName
- resources.hostName
- resources.id
- resources.metaData
- resources.name
- resources.resourceName
- resources.resourceType
- resources.type
rollbackPlanstring
Description of roll back plan.
scheduleobject
Child Parameters
- schedule.endTime
- Schedule end time.
- schedule.pattern
- Recurrence pattern.
- schedule.startTime
- Schedule start time.
- schedule.timezone
- Schedule time zone. The list of timezones are shown below. Example: "timezone": "America/Los_Angeles"
- schedule.type
- Schedule type.
serviceRestoreDatestring
slaDetailsobject
Child Parameters
- slaDetails.resolutionBreach
- slaDetails.resolutionBreachDate
- slaDetails.resolutionTime
- slaDetails.responseBreach
- slaDetails.responseBreachDate
- slaDetails.responseTime
- slaDetails.slaPolicy
sourcestring
sourceEntityTypestring
sourceEntityTypeIdstring
sourcePolicyTypestring
sourcePolicyTypeIdstring
statusstring
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
subCategoryobject
Add the change request under a sub-category. Use get categories to get the list of sub-categories.
Child Parameters
- subCategory.id
subjectstring
Ticket subject.
tagsstring
testPlanstring
Description of test plan.
ticketArisedTimestring
toEmailstring
Email address of the user. An email notification is sent to the user.
updatedDatestring
workEndstring
workStartstring
{
"assignedUser": {
"id": "USR0000002146",
"loginName": "FSSL-API-Lab-User-1"
},
"assigneeGroup": {
"name": "API-Lab-Group-1"
},
"attachedRequests": [
{
"id": "SRQ0000001388"
},
{
"id": "SRQ0000001391"
},
{
"id": "SRQ0000001394"
},
{
"id": "SRQ0000001397"
}
],
"businessImpact": {
"id": 10
},
"category": {
"id": 12
},
"cc": "network.admins@myorganization.com, tech.admins@myorganization.com",
"changeRequest": {
"id": "CHG0000001028"
},
"customFields": [
{
"id": "UDF0000003790",
"name": "drop_down_api_lab_3790",
"value": "2"
},
{
"id": "UDF0000003791",
"name": "text_api_lab_3791",
"value": "request custom field - text"
},
{
"id": "UDF0000003810",
"name": "numeric_3810",
"value": "10"
},
{
"id": "UDF0000003792",
"name": "multi_line_text_api_lab_3792",
"value": "Third party ticket"
},
{
"id": "UDF0000003794",
"name": "checkbox_api_lab_3794",
"value": "1"
},
{
"id": "UDF0000003795",
"name": "date_ap_lab_3795",
"value": "2016-02-26T00:00:00+0000"
},
{
"id": "UDF0000003796",
"name": "datetime_api_lab_3796",
"value": "2016-02-26T12:13:00+0000"
}
],
"dueDate": "2016-03-28T06:43:00+0000",
"knowledgeArticleIds": [
14,
22
],
"parentId": "INC0000001145",
"priority": "Low",
"problem": {
"id": "PRB0000001105"
},
"reason": "On hold Reason",
"requester": {
"id": "USR0000002146",
"loginName": "FSSL-API-Lab-User-1"
},
"resources": [
{
"id": "481af404-33a6-4d61-af77-c483ca6641fa"
},
{
"id": "SGP-7adf3762-f310-4c14-9ecd-443eb7c6c208"
},
{
"id": "DGP-8d44a504-fd4b-4a78-ba34-2dfdf3ffb85e"
}
],
"response": {
"attachments": [
{
"file": "U2FtcGxlIFRleHQgZmlsZS0gdGVzdGluZyB3aXRoIGF0dGFjaG1lbnQ=",
"name": "server incidents.txt"
},
{
"file": "U2FtcGxlIFRleHQgZmlsZS0gdGVzdGluZyB3aXRoIGF0dGFjaG1lbnQ=",
"name": "windows incidents.txt"
}
],
"creator": {
"id": "USR0000002146",
"loginName": "John.Smith"
},
"description": "Adding Attachments to Incident",
"extTicketResponseId": "12345",
"internal": "false",
"tags": "Server, Incident"
},
"status": "On Hold",
"subCategory": {
"id": 13
},
"subject": "Window servers down in West-SJ",
"ticketArisedTime": "2016-02-26T06:43:00+0000",
"toEmail": "sam.rivers@myorganization.com,john.blake@myorganization.com",
"urgency": {
"id": 25
}
}
Responses
OK
alertIdsarray
allowedStatusarray
Child Parameters
- allowedStatus.id
- allowedStatus.name
- allowedStatus.reasonsDefined
- allowedStatus.reasonsEnabled
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
attachedRequestsarray
Attach service requests to an incident. Use the search service requests to get list of service requests in a client.
Child Parameters
- attachedRequests.id
attachmentsarray
Attach files related to the change request. Convert attachment files to byte stream with base64-encoding. The file size limit of an attachment is 50 MB.
Child Parameters
- attachments.file
- attachments.name
businessImpactobject
Child Parameters
- businessImpact.createdBy
- businessImpact.createdDate
- businessImpact.description
- (Optional) Short summary describing the business impact.
- businessImpact.name
- Business impact name.
- businessImpact.uniqueId
- businessImpact.updatedBy
- businessImpact.updatedDate
categoryobject
Add the change request under a category. Use the get API to get the list of categories.
Child Parameters
- category.id
ccstring
Cc email.
changePlanstring
Description of the change plan.
changeRequestobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- changeRequest.id
changeTypestring
Normal or Emergency depending on the Priority of a change request. For example, create a change type Emergency for change requests that must be processed immediately or if Priority of a request is High.
channelIdstring
clientobject
Child Parameters
- client.activated
- client.createdTime
- client.id
- client.name
- client.uniqueId
- client.updatedTime
closedSummarystring
consolesarray
Child Parameters
- consoles.consoleProtocol
- Console protocol.
- consoles.options
- Console options.
- consoles.type
- Console type
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
Ticket description.
dueDatestring
extTicketIdstring
Attach third party ticket ID.
idstring
knowledgeArticleIdsarray
Attach knowledge base articles related to the change request 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
locationstring
notesstring
oldPrioritystring
oldStatusstring
parentIdstring
Attach incident. Provide the incident ID as an attachment.
plannedEndstring
plannedStartstring
policyobject
Child Parameters
- policy.active
- policy.createdDate
- policy.executionOrder
- policy.id
- policy.name
- policy.policyType
- policy.updatedDate
prioritystring
Ticket priority with supported priority values: Low, Normal, High, Urgent, and Very Low.
priorityUpdatedByobject
Child Parameters
- priorityUpdatedBy.email
- priorityUpdatedBy.firstName
- priorityUpdatedBy.id
- priorityUpdatedBy.lastName
- priorityUpdatedBy.loginName
- priorityUpdatedBy.phoneNumber
priorityUpdatedDatestring
problemobject
Attach a problem or change request related to the incident. Only a single change request or problem can be attached to an incident.
Child Parameters
- problem.id
reOpenCountinteger
requesterobject
Child Parameters
- requester.email
- requester.firstName
- requester.id
- requester.lastName
- requester.loginName
- requester.phoneNumber
resolutionSummarystring
resolveDatestring
resourcesarray
Child Parameters
- resources.aliasName
- resources.hostName
- resources.id
- resources.metaData
- resources.name
- resources.resourceName
- resources.resourceType
- resources.type
rollbackPlanstring
Description of roll back plan.
scheduleobject
Child Parameters
- schedule.endTime
- Schedule end time.
- schedule.pattern
- Recurrence pattern.
- schedule.startTime
- Schedule start time.
- schedule.timezone
- Schedule time zone. The list of timezones are shown below. Example: "timezone": "America/Los_Angeles"
- schedule.type
- Schedule type.
serviceRestoreDatestring
slaDetailsobject
Child Parameters
- slaDetails.resolutionBreach
- slaDetails.resolutionBreachDate
- slaDetails.resolutionTime
- slaDetails.responseBreach
- slaDetails.responseBreachDate
- slaDetails.responseTime
- slaDetails.slaPolicy
sourcestring
sourceEntityTypestring
sourceEntityTypeIdstring
sourcePolicyTypestring
sourcePolicyTypeIdstring
statusstring
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
subCategoryobject
Add the change request under a sub-category. Use get categories to get the list of sub-categories.
Child Parameters
- subCategory.id
subjectstring
Ticket subject.
tagsstring
testPlanstring
Description of test plan.
ticketArisedTimestring
toEmailstring
Email address of the user. An email notification is sent to the user.
updatedDatestring
workEndstring
workStartstring
{
"alertIds": [],
"allowedStatus": [
{
"id": "1",
"name": "New",
"reasonsDefined": false,
"reasonsEnabled": false
},
{
"id": "3",
"name": "Pending",
"reasonsDefined": false,
"reasonsEnabled": true
},
{
"id": "5",
"name": "Closed",
"reasonsDefined": false,
"reasonsEnabled": true
}
],
"assignedUser": {
"email": "john.smith@myorganization.com",
"firstName": "John",
"id": "USR0000002146",
"lastName": "Smith",
"loginName": "John.Smith"
},
"assigneeGroup": {
"id": 17,
"name": "Network Administrators",
"userCount": 2
},
"attachedRequests": [
{
"id": "SRQ0000001388"
},
{
"id": "SRQ0000001391"
},
{
"id": "SRQ0000001394"
},
{
"id": "SRQ0000001397"
}
],
"businessImpact": {
"description": "Impact level 2",
"id": 10,
"name": "Impact 2"
},
"cc": "network.admins@myorganization.com, tech.admins@myorganization.com",
"client": {
"activated": true,
"createdTime": "2012-10-09T11:49:34+0000",
"id": 7,
"name": "API Lab",
"uniqueId": "client_7",
"updatedTime": ""
},
"createdDate": "2016-03-29T12:20:15+0000",
"createdUser": {
"email": "john.smith@myorganization.com",
"firstName": "John",
"id": "USR0000002095",
"lastName": "Smith",
"loginName": "John.Smith"
},
"customFields": [
{
"classCode": "INCIDENT",
"defaultValue": "",
"description": "all partners",
"displayLabel": "text field",
"editable": true,
"fieldType": "TYPE_TEXT",
"id": "UDF0000003808",
"mandatory": false,
"name": "text_field_3808",
"value": "available"
},
{
"classCode": "INCIDENT",
"defaultValue": "",
"description": "testing numeric",
"displayLabel": "numeric",
"editable": true,
"fieldType": "TYPE_NUMBER",
"id": "UDF0000003810",
"mandatory": false,
"name": "numeric_3810",
"value": "120"
},
{
"classCode": "INCIDENT",
"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": "INCIDENT",
"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",
"value": "text"
},
{
"classCode": "INCIDENT",
"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"
}
],
"selectedOption": {
"label": "yes",
"value": "1"
},
"value": "1"
},
{
"classCode": "INCIDENT",
"defaultValue": "2016-02-26T00:00: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",
"value": "2016-02-26T00:00:00+0000"
},
{
"classCode": "INCIDENT",
"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",
"value": "2016-02-26T12:13:00+0000"
}
],
"description": "Unable to upgrade to latest Windows version",
"dueDate": "2016-03-28T12:13:00+0000",
"extTicketId": "000042526342",
"id": "INC0000001114",
"knowledgeArticleIds": [
14,
22
],
"oldPriority": "Low",
"oldStatus": "New",
"priority": "Low",
"priorityUpdatedBy": {
"email": "fssl.lab@myorganization.com",
"firstName": "FSSL",
"id": "USR0000002146",
"lastName": "API-Lab",
"loginName": "FSSL-API-Lab-User-1"
},
"priorityUpdatedDate": "2016-03-29T12:20:15+0000",
"reason": "On Hold Reason",
"referenceArticles": [
{
"id": 14,
"subject": "Troubleshoot a Windows Network"
},
{
"id": 22,
"subject": "Windows Network Connect Details"
}
],
"requester": {
"email": "james.hudson@myorganization.com",
"firstName": "James",
"id": "USR0000002146",
"lastName": "Hudson",
"loginName": "James.Hudson"
},
"resources": [
{
"id": "481af404-33a6-4d61-af77-c483ca6641fa",
"name": "VTHLPT1000",
"type": "DEVICE"
},
{
"id": "SGP-7adf3762-f310-4c14-9ecd-443eb7c6c208",
"name": "VTH-SERVICES",
"type": "SERVICE"
},
{
"id": "DGP-8d44a504-fd4b-4a78-ba34-2dfdf3ffb85e",
"name": "VTH-ADMIN-DEVS",
"type": "DEVICE_GROUP"
}
],
"serviceRestoreDate": "2016-03-28T12:13:00+0000",
"slaDetails": {
"resolutionBreach": false,
"resolutionBreachDate": "",
"resolutionTime": 0,
"responseBreach": false,
"responseBreachDate": "",
"responseTime": 683
},
"source": "INTEGRATION",
"sourceEntityType": "INCIDENT",
"sourceEntityTypeId": "000042526342",
"status": "On Hold",
"statusFlow": [
{
"createdDate": "2016-07-25T12:42:19+0000",
"status": "New",
"timeSpent": 1492634,
"updatedBy": {
"email": "ops.admin@myorganization.com",
"firstName": "Ops Admin",
"lastName": " ",
"loginName": "ops_admin_user"
}
},
{
"createdDate": "2016-11-22T10:04:44+0000",
"reason": "On Hold Reason",
"status": "On Hold",
"updatedBy": {
"email": "ops.admin@myorganization.com",
"firstName": "Ops Admin",
"lastName": " ",
"loginName": "ops_admin_user"
}
}
],
"statusUpdatedBy": {
"email": "admin.dev@myorganization.com",
"firstName": "admins",
"id": "USR0000002095",
"lastName": "development",
"loginName": "admin.dev"
},
"statusUpdatedDate": "2016-03-29T12:31:38+0000",
"subject": "Window servers down in West-SJ",
"ticketArisedTime": "2016-02-26T12:13:00+0000",
"toEmail": "sam.rivers@myorganzation.com,john.blake@myorganization.com",
"updatedDate": "2016-03-29T12:42:50+0000",
"urgency": {
"description": "Urgency level 1",
"id": 25,
"name": "Urgency 1"
}
}