Update integration event

URL

POST https://{api-url}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}/event/{eventId}

Sample URLs

https://{api-url}/api/v2/tenants/client_9/integrations/installed/INTG-6df698c6-12f1-4af5-88ed-da9f2a8b4b94/event/INTG-EVENT-c4bd7463-6164-47cb-909a-d18cab124282

Parameters

All fields are optional:

Field	Data Type	Description
name	String	Name of the Integration event.
entity	String	OpsRamp entity on which an action is performed. Supported entities include: Service Desk INCIDENT SERVICEREQUEST CHANGE PROBLEM TASK Resource Alert ALERT (used only when eventType is selected as NONE)
eventType	String	Type of action performed on the entity. Supported values include: NONE (Used to invoke external integration through process workflow) CREATE UPDATE DELETE
filterCriteria id matchType rules resourceType key operator value	String	Filter entities on which the event is added to the rules: Match All or Any of the rules. Supported Values: ANY, ALL Rules to filter the entities: Entity to which the event is added. The unique property of the entity. Example: Subject, Description. Matching parameter Supported Values: Contains, Not Contains, Equals, Not Equals, Starts with, Ends with, Regex. Example: resourceType: Incident, key: Subject, operator: Contains, value: Windows. Value of the entity.
useBaseNotifier	Boolean	Notification details to trigger events defined. To configure integration base notifier: Provide useBaseNotifier: true to assign the notifier details to the event. Provide useBaseNotifier: false to assign different notifier details Supported Values: true, false.
notifier type baseURI authType grantType userName password apiKey apiSecret accessTokenURL	String	(Mandatory if useBaseNotifier is false) Define notification details to trigger events: Notification type. Supported values include: REST_API SOAP_API Authentication type. Supported values include: BASIC OAUTH2 NONE Grant type. Mandatory if authType is OAUTH2. Supported values include: CLIENT_CREDENTIALS PASSWORD REFRESH_TOKEN Username. Mandatory if authType is BASIC or OAUTH2 and grantType is PASSWORD or REFRESH_TOKEN. Password. Mandatory if authType is BASIC or OAUTH2 and grantType is PASSWORD or REFRESH_TOKEN. Key configured in third-party integration. Mandatory if authType is OAUTH2. Secret configured in third-party integration. Mandatory if authType is OAUTH2. Access token URL. Mandatory if authType is OAUTH2.
endPointURI	String
thirdPartyEventType	String	Type of action performed on the entity.Supported Values: POST, PUT, GET, DELETE, and PATCH
headers key value	String	Headers Header name Header value
payload	File	Third-party integration event payload. Provide the third-party payload with OpsRamp placeholders to integrate the event between OpsRamp and third-party: To get OpsRamp tokens, use refer to the Get Integration Event Placeholders API. Convert the payload to base 64 and provide the file in the field file in the below sample request.
responseHeaders key value	String	Response headers: Response header name Response header value

Note

Provide API payload in Base64 encoding.
Integration event for Alert entity is created only using API but can be viewed from the OpsRamp Portal.

Sample request

{
	"name" : "Create event with policy and dep updated",
	"entity" : "INCIDENT",
	"eventType" : "CREATE",
	"filterCriteria" : {
		"id" : 141,
		"matchType" : "ANY",
		"rules" : [
			{
				"id" : 581,
				"key" : "Subject",
				"operator" : "Contains",
				"value" : "test",
				"resourceType" : "INCIDENT"
			},
			{
				"id" : 582,
				"key" : "Description",
				"operator" : "Contains",
				"value" : "testing",
				"resourceType" : "INCIDENT"
			}
		]
	},
	"notifier" : {
		"type" : "SOAP_API",
		"baseURI" : "www.google.com",
		"authType" : "BASIC",
		"userName" : "testUser",
		"password" : "test"
	},
	"headers" : [
		{
			"key" : "accept",
			"value" : "application/json"
		},
		{
			"key" : "Content-Type",
			"value" : "application/json"
		}
	],
	"thirdPartyEventType" : "POST",
	"payload" : "ew0KInN1YmplY3QiOiIkaW5jaWRlbnQuc3ViamVjdCIsDQoiZGVzY3JpcHRpb24iOiIkaW5jaWRlbnQuaW1wYWN0IiwNCiJwcmlvcml0eSI6IiRpbmNpZGVudC5wcmlvcml0eS5uYW1lIg0KInN0YXV0cyI6ImhpZ2giDQp9"
}

Sample response

{
	"id" : "INTG-EVENT-c6d30f9c-2728-4760-ad97-8f3b6f2b6391",
	"name" : "Create event with policy and dep updated",
	"entity" : "INCIDENT",
	"filterCriteria" : {
		"id" : 141,
		"name" : "Create event with policy and dep",
		"matchType" : "ANY",
		"rules" : [
			{
				"id" : 581,
				"key" : "Subject",
				"operator" : "Contains",
				"value" : "test",
				"resourceType" : "INCIDENT"
			},
			{
				"id" : 582,
				"key" : "Description",
				"operator" : "Contains",
				"value" : "testing",
				"resourceType" : "INCIDENT"
			}
		],
		"actions" : []
	},
	"notifier" : {
		"baseURI" : "www.google.com",
		"authType" : "BASIC",
		"userName" : "testUser"
	},
	"headers" : [
		{
			"key" : "accept",
			"value" : "application/json"
		},
		{
			"key" : "Content-Type",
			"value" : "application/json"
		}
	],
	"eventPayload" : "{\r\n"subject":"$incident.subject",\r\n"description":"$incident.impact",\r\n"priority":"$incident.priority.name"\r\n"stauts":"high"\r\n}"
}