addMergeGroup

A Graze API POST request that adds a new custom merge group.

Request arguments

Endpoint addMergeGroup takes the following request arguments:

Name	Type	Required	Description
`name`	String	Yes	A unique name for the custom merge group.
`moolets`	Array of Strings	Yes	List of clustering algorithm Moolets to include in the custom merge group.
`alert_threshold`	Integer	No	Minimum number of alerts that must be present in a cluster before it can become a Situation. Must be greater than or equal to 1. Enter `null` if you want the custom merge group to use the default merge group value. Default merge group value is 2.
`situation_similarity_limit`	Floating Point	No	Percentage of alerts two Situations must share before they are merged for this group. Enter a value between 0 and 1. Enter `null` if you want the merge group to use the default merge group value.

Response

Endpoint addMergeGroup returns the following response:

Type	Description
HTTP Code	HTTP status or error code indicating request success or failure. See HTTP status code definitions for more information.

Examples

The following examples demonstrate typical use of endpoint addMergeGroup:

Request example

Example cURL request to create a new custom merge group:

curl -X POST 
-u graze:graze 
-k -v "https://localhost/graze/v1/addMergeGroup" 
-H "Content-Type: application/json; charset=UTF-8" 
-d '{"name":"Merge Group 1","moolets":["Time Based (Tempus)", "Recipe 2"],"alert_threshold":2,"situation_similarity_limit":0.6}'

Response example

In this section: