curl --request PUT \
--url https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId} \
--header 'Content-Type: application/json' \
--header 'X-Honeycomb-Team: <api-key>' \
--data '
{
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"frequency": 123,
"alert_type": "on_change",
"disabled": false,
"recipients": [
{
"id": "<string>",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": true
},
"group_filter": {},
"pagerduty_per_group_incidents": true
}
],
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}
'import requests
url = "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}"
payload = {
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"frequency": 123,
"alert_type": "on_change",
"disabled": False,
"recipients": [
{
"id": "<string>",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": True
},
"group_filter": {},
"pagerduty_per_group_incidents": True
}
],
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}
headers = {
"X-Honeycomb-Team": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-Honeycomb-Team': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
tags: [{key: 'team', value: 'blue'}],
frequency: 123,
alert_type: 'on_change',
disabled: false,
recipients: [
{
id: '<string>',
target: '<string>',
details: {
pagerduty_severity: 'critical',
variables: [{name: 'severity', value: 'warning'}],
muted: true
},
group_filter: {},
pagerduty_per_group_incidents: true
}
],
baseline_details: {offset_minutes: 60, type: 'percentage'},
query: {},
query_id: '<string>'
})
};
fetch('https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => '<string>',
'tags' => [
[
'key' => 'team',
'value' => 'blue'
]
],
'frequency' => 123,
'alert_type' => 'on_change',
'disabled' => false,
'recipients' => [
[
'id' => '<string>',
'target' => '<string>',
'details' => [
'pagerduty_severity' => 'critical',
'variables' => [
[
'name' => 'severity',
'value' => 'warning'
]
],
'muted' => true
],
'group_filter' => [
],
'pagerduty_per_group_incidents' => true
]
],
'baseline_details' => [
'offset_minutes' => 60,
'type' => 'percentage'
],
'query' => [
],
'query_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Honeycomb-Team: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Honeycomb-Team", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}")
.header("X-Honeycomb-Team", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Honeycomb-Team"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"dataset_slug": "<string>",
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"threshold": {
"op": ">",
"value": 123,
"exceeded_limit": 1
},
"frequency": 123,
"alert_type": "on_change",
"disabled": false,
"triggered": true,
"recipients": [
{
"id": "<string>",
"type": "pagerduty",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": true
},
"group_filter": {},
"pagerduty_per_group_incidents": true
}
],
"evaluation_schedule_type": "frequency",
"evaluation_schedule": {
"window": {
"days_of_week": [
"sunday"
],
"start_time": 840,
"end_time": 1260
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}{
"error": "<string>"
}{
"error": "unknown API key - check your credentials"
}{
"error": "Your team has been denied access to Management APIs, please contact support to be unblocked."
}{
"error": "dataset not found"
}{
"error": "something went wrong!",
"status": 422,
"type": "https://api.honeycomb.io/problems/validation-failed",
"title": "The provided input is invalid.",
"detail": "<string>",
"instance": "<string>",
"type_detail": [
{
"field": "<string>",
"code": "invalid",
"description": "<string>"
}
]
}{
"error": "Rate Limited"
}Update a Trigger
Update a trigger by specifying the trigger ID and the same fields used when creating a new trigger.
curl --request PUT \
--url https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId} \
--header 'Content-Type: application/json' \
--header 'X-Honeycomb-Team: <api-key>' \
--data '
{
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"frequency": 123,
"alert_type": "on_change",
"disabled": false,
"recipients": [
{
"id": "<string>",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": true
},
"group_filter": {},
"pagerduty_per_group_incidents": true
}
],
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}
'import requests
url = "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}"
payload = {
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"frequency": 123,
"alert_type": "on_change",
"disabled": False,
"recipients": [
{
"id": "<string>",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": True
},
"group_filter": {},
"pagerduty_per_group_incidents": True
}
],
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}
headers = {
"X-Honeycomb-Team": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-Honeycomb-Team': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
description: '<string>',
tags: [{key: 'team', value: 'blue'}],
frequency: 123,
alert_type: 'on_change',
disabled: false,
recipients: [
{
id: '<string>',
target: '<string>',
details: {
pagerduty_severity: 'critical',
variables: [{name: 'severity', value: 'warning'}],
muted: true
},
group_filter: {},
pagerduty_per_group_incidents: true
}
],
baseline_details: {offset_minutes: 60, type: 'percentage'},
query: {},
query_id: '<string>'
})
};
fetch('https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'description' => '<string>',
'tags' => [
[
'key' => 'team',
'value' => 'blue'
]
],
'frequency' => 123,
'alert_type' => 'on_change',
'disabled' => false,
'recipients' => [
[
'id' => '<string>',
'target' => '<string>',
'details' => [
'pagerduty_severity' => 'critical',
'variables' => [
[
'name' => 'severity',
'value' => 'warning'
]
],
'muted' => true
],
'group_filter' => [
],
'pagerduty_per_group_incidents' => true
]
],
'baseline_details' => [
'offset_minutes' => 60,
'type' => 'percentage'
],
'query' => [
],
'query_id' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Honeycomb-Team: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-Honeycomb-Team", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}")
.header("X-Honeycomb-Team", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.honeycomb.io/1/triggers/{datasetSlug}/{triggerId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-Honeycomb-Team"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"tags\": [\n {\n \"key\": \"team\",\n \"value\": \"blue\"\n }\n ],\n \"frequency\": 123,\n \"alert_type\": \"on_change\",\n \"disabled\": false,\n \"recipients\": [\n {\n \"id\": \"<string>\",\n \"target\": \"<string>\",\n \"details\": {\n \"pagerduty_severity\": \"critical\",\n \"variables\": [\n {\n \"name\": \"severity\",\n \"value\": \"warning\"\n }\n ],\n \"muted\": true\n },\n \"group_filter\": {},\n \"pagerduty_per_group_incidents\": true\n }\n ],\n \"baseline_details\": {\n \"offset_minutes\": 60,\n \"type\": \"percentage\"\n },\n \"query\": {},\n \"query_id\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"dataset_slug": "<string>",
"name": "<string>",
"description": "<string>",
"tags": [
{
"key": "team",
"value": "blue"
}
],
"threshold": {
"op": ">",
"value": 123,
"exceeded_limit": 1
},
"frequency": 123,
"alert_type": "on_change",
"disabled": false,
"triggered": true,
"recipients": [
{
"id": "<string>",
"type": "pagerduty",
"target": "<string>",
"details": {
"pagerduty_severity": "critical",
"variables": [
{
"name": "severity",
"value": "warning"
}
],
"muted": true
},
"group_filter": {},
"pagerduty_per_group_incidents": true
}
],
"evaluation_schedule_type": "frequency",
"evaluation_schedule": {
"window": {
"days_of_week": [
"sunday"
],
"start_time": 840,
"end_time": 1260
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"baseline_details": {
"offset_minutes": 60,
"type": "percentage"
},
"query": {},
"query_id": "<string>"
}{
"error": "<string>"
}{
"error": "unknown API key - check your credentials"
}{
"error": "Your team has been denied access to Management APIs, please contact support to be unblocked."
}{
"error": "dataset not found"
}{
"error": "something went wrong!",
"status": 422,
"type": "https://api.honeycomb.io/problems/validation-failed",
"title": "The provided input is invalid.",
"detail": "<string>",
"instance": "<string>",
"type_detail": [
{
"field": "<string>",
"code": "invalid",
"description": "<string>"
}
]
}{
"error": "Rate Limited"
}Authorizations
Authenticate using a Honeycomb Configuration Key.
Pass the Token in the X-Honeycomb-Team header:
X-Honeycomb-Team: 1234567890123456789012
If you created your key using the API, use data.attributes.secret; this is the same value as the Token in the UI.
To learn how to create a Configuration Key, visit Manage Environment API Keys. To learn more about authenticating requests, visit API Authentication.
Path Parameters
Body
The interval in seconds in which to check the results of the query’s calculation against the threshold. Cannot be more than 4 times the query's duration (i.e. duration <= frequency*4). See A Caveat on Time for more information on specifying a query's duration. minimum: 60 maximum: 86400 multipleOf: 60 default: 900
How often to fire an alert when a trigger threshold is crossed.
on_changesends a trigger notification when the result of the specified calculation crosses the threshold. The trigger resolves only when the result of the query no longer satisfies the threshold condition.on_truekeeps sending a trigger notification at current frequency when and while the threshold is met. (This reflects the same behavior as the "Send an alert every time a threshold is met" checkbox in the Honeycomb UI.)on_group_changesends notifications when individual groups cross or resolve the threshold.
on_change, on_true, on_group_change A list of Recipients to notify when the Trigger fires.
Using type+target is deprecated.
First, create the Recipient via the Recipients API, and then specify the ID.
A Recipient can appear only once; define at most one routing rule per Recipient.
Show child attributes
Show child attributes
The schedule type used by the trigger. The default is frequency, where the trigger runs at the specified frequency. The window type means that the trigger will run at the specified frequency, but only in the time window specified in the evaluation_schedule field.
frequency, window An inline query specification that is a strict subset of the standard Query Specification.
Required Fields:
calculations: At least one aggregate calculation (e.g., COUNT, AVG, SUM). Cannot use HEATMAP or CONCURRENCY.time_range: Query duration in seconds. Must be between the triggerfrequencyand the lesser of (4 ×frequency) or 86400 (24 hours).
Prohibited Fields:
orders: Not supported. Trigger queries automatically order results based on the threshold operator.limit: Not supported. All matching result groups are evaluated.start_timeandend_time: Not supported. Usetime_rangeinstead for relative time windows.usage_mode: Not supported for triggers.
Calculation Restrictions:
- Without formulas: Maximum 1 non-having aggregate allowed.
- With formulas: Maximum 1 formula allowed, with up to 100 aggregates.
- Maximum 1 HAVING clause allowed, which must correspond to an existing calculation.
- Named aggregates cannot be combined with global
filters.
Metrics Dataset Specific:
granularityfield is supported and must be within calculated min/max bounds based on time range.- Nil aggregate values are skipped during trigger evaluation (no error, group is simply not evaluated).
- Requires a non-legacy environment.
Standard Datasets:
granularityfield is not supported.
Learn more about Triggers.
The ID of an existing saved Query that meets the trigger query requirements.
The referenced query must satisfy the same restrictions as inline trigger queries:
- Must have at least one aggregate calculation (not HEATMAP or CONCURRENCY)
- Cannot have
orders,limit,start_time,end_time, orusage_modefields set - Must have appropriate
time_rangerelative to trigger frequency - Must respect calculation restrictions (max 1 non-having aggregate without formulas, or max 1 formula with up to 100 aggregates)
- Maximum 1 having clause allowed
- Named aggregates cannot be combined with global filters
- For metrics datasets: may include
granularityfield (within calculated bounds) - For standard datasets: must not include
granularityfield
The API will validate the referenced query meets these criteria when creating or updating the trigger.
See the inline query field documentation above for complete trigger query requirements and learn more about Triggers.
Response
Success
The interval in seconds in which to check the results of the query’s calculation against the threshold. Cannot be more than 4 times the query's duration (i.e. duration <= frequency*4). See A Caveat on Time for more information on specifying a query's duration. minimum: 60 maximum: 86400 multipleOf: 60 default: 900
How often to fire an alert when a trigger threshold is crossed.
on_changesends a trigger notification when the result of the specified calculation crosses the threshold. The trigger resolves only when the result of the query no longer satisfies the threshold condition.on_truekeeps sending a trigger notification at current frequency when and while the threshold is met. (This reflects the same behavior as the "Send an alert every time a threshold is met" checkbox in the Honeycomb UI.)on_group_changesends notifications when individual groups cross or resolve the threshold.
on_change, on_true, on_group_change A list of Recipients to notify when the Trigger fires.
Using type+target is deprecated.
First, create the Recipient via the Recipients API, and then specify the ID.
A Recipient can appear only once; define at most one routing rule per Recipient.
Show child attributes
Show child attributes
The schedule type used by the trigger. The default is frequency, where the trigger runs at the specified frequency. The window type means that the trigger will run at the specified frequency, but only in the time window specified in the evaluation_schedule field.
frequency, window An inline query specification that is a strict subset of the standard Query Specification.
Required Fields:
calculations: At least one aggregate calculation (e.g., COUNT, AVG, SUM). Cannot use HEATMAP or CONCURRENCY.time_range: Query duration in seconds. Must be between the triggerfrequencyand the lesser of (4 ×frequency) or 86400 (24 hours).
Prohibited Fields:
orders: Not supported. Trigger queries automatically order results based on the threshold operator.limit: Not supported. All matching result groups are evaluated.start_timeandend_time: Not supported. Usetime_rangeinstead for relative time windows.usage_mode: Not supported for triggers.
Calculation Restrictions:
- Without formulas: Maximum 1 non-having aggregate allowed.
- With formulas: Maximum 1 formula allowed, with up to 100 aggregates.
- Maximum 1 HAVING clause allowed, which must correspond to an existing calculation.
- Named aggregates cannot be combined with global
filters.
Metrics Dataset Specific:
granularityfield is supported and must be within calculated min/max bounds based on time range.- Nil aggregate values are skipped during trigger evaluation (no error, group is simply not evaluated).
- Requires a non-legacy environment.
Standard Datasets:
granularityfield is not supported.
Learn more about Triggers.
The ID of an existing saved Query that meets the trigger query requirements.
The referenced query must satisfy the same restrictions as inline trigger queries:
- Must have at least one aggregate calculation (not HEATMAP or CONCURRENCY)
- Cannot have
orders,limit,start_time,end_time, orusage_modefields set - Must have appropriate
time_rangerelative to trigger frequency - Must respect calculation restrictions (max 1 non-having aggregate without formulas, or max 1 formula with up to 100 aggregates)
- Maximum 1 having clause allowed
- Named aggregates cannot be combined with global filters
- For metrics datasets: may include
granularityfield (within calculated bounds) - For standard datasets: must not include
granularityfield
The API will validate the referenced query meets these criteria when creating or updating the trigger.
See the inline query field documentation above for complete trigger query requirements and learn more about Triggers.