Service Audience Template API

🚧
If using the EU instance of Opsgenie, the URL needs to be https://api.eu.opsgenie.com for requests to be successful.

Update Audience Template(Partial)

Update audience template request is used to update the audience template (responder and/or stakeholder) of a service and it is a write request. If the integration of the API key configured as read-only, the request will not be accepted. For more information, you can refer to API Access Management.

HTTP Method	URL
PATCH	https://api.opsgenie.com/v1/services/:serviceId/audience-templates

Field	Mandatory	Description	Limit
serviceId	true	Id of the service on which audience template will be updated.	130 characters
audienceTemplate	false	Field will be updated.For more information about audience template object click here.

Sample Requests

curl -X PATCH 'https://api.opsgenie.com/v1/services/725fa6c4-ef29-4bda-8172-135135a9e8f3/audience-templates' -H 'Authorization: GenieKey eb24alp-faa2-4ba2-a551q-1alpf565c889' -H 'Content-Type: application/json' -d '{	"responder": {	"individuals": ["22b852e0-cf95-4fe6-927b-ebf221331dc6"],	"teams": ["dd64998f-80fd-4a1d-9b36-aeb1a86eb0ad"]	},	"stakeholder": {	"individuals": ["22b852e0-cf95-4fe6-927b-ebf221331dc6"],	"conditionMatchType": "match-any-condition",	"conditions": [{	"matchField": "country",	"value": "canada"	}, {	"matchField": "customProperty",	"key": "country",	"value": "usa"	}]	} }'

Response:

{ "result": "Updated", "requestId": "29516144-e1a2-11e7-b939-05f0fad0ed41" }

Get Audience Template

Get audience template request is used to retrieve the audience template of a service

HTTP Method	URL
GET	https://api.opsgenie.com/v1/services/:serviceId/audience-templates

Field	Mandatory	Description	Limit
serviceId	true	Id of the service from which audience template will be retrieved.	130 characters

Request

curl -X GET 'https://api.opsgenie.com/v1/services/23b852C0-cf95-4fe6-927b-ebf221331dc6/audience-templates' -H 'Authorization: GenieKey eb24alp-faa2-4ba2-a551q-1alpf565c889' -H 'Content-Type: application/json'

https://api.opsgenie.com/v1/services/a418e1de-fa89-48b0-8a83-5e649bc1a1ee/audience-templates

Response

{ "data": { "responder": { "teams": [ "dd64998f-80fd-4a1d-9b36-aeb1a86eb0ad" ], "individuals": [ "22b852e0-cf95-4fe6-927b-ebf221331dc6" ] }, "stakeholder": { "individuals": [ "22b852e0-cf95-4fe6-927b-ebf221331dc6" ], "conditionMatchType": "match-any-condition", "conditions": [ { "matchField": "country", "value": "turkey" }, { "matchField": "customProperty", "key": "country", "value": "turkey" } ] } }, "requestId": "bd0c9c2a-e19b-11e7-8406-4dd3ac13f41e" }

Audience Template Fields

Field	Mandatory	Description
responder	false	Responder of the audience template. It may contain responder team and user ids.For more information about responder object click here.
stakeholder	false	Stakeholder of the audience template. It may contain pre-defined individuals and match type configuration conditions for rule based notifications.For more information about stakeholder object click here.

Responder Fields

Field	Mandatory	Description	Limit
teams	false	teamId list to be used as responder teams.	50 teams
individuals	false	userId list to be used as responder users.	50 userIds

Stakeholder Fields

Field	Mandatory	Description
individuals	false	userId list to be used as stakeholders.
conditionMatchType	false	Match type for given conditions. Possible values are [match-all-conditions, match-any-condition]. Default value is [match-any-condition].
conditions	false	Condition array which contains match-type conditions.For more information about conditions object click here.

Conditions Fields

Field	Mandatory	Description
matchField	true	field to be matched for users. Possible values are [country, state, city, zipCode, line, tag, customProperty]. customProperty can be used while actionType is keyValue.
key	false	if matchField is customProperty, key must be given.
value	true	value to be check for the match field.