Create an alert

Version 4.0.24.12

Create a new alert and return details of the newly created object

Required fields: field, destinations, comparison_type, threshold, cron

Example Request: Run alert on dashboard element '103' at 5am every day. Send an email to 'test@test.com' if inventory for Los Angeles (using dashboard filter Warehouse Name) is lower than 1,000

{
  "cron": "0 5 * * *",
  "custom_title": "Alert when LA inventory is low",
  "dashboard_element_id": 103,
  "applied_dashboard_filters": [
    {
      "filter_title": "Warehouse Name",
      "field_name": "distribution_centers.name",
      "filter_value": "Los Angeles CA",
      "filter_description": "is Los Angeles CA"
    }
  ],
  "comparison_type": "LESS_THAN",
  "destinations": [
    {
      "destination_type": "EMAIL",
      "email_address": "test@test.com"
    }
  ],
  "field": {
    "title": "Number on Hand",
    "name": "inventory_items.number_on_hand"
  },
  "is_disabled": false,
  "is_public": true,
  "threshold": 1000
}

Request

POST /alerts
Datatype
Description
Request
HTTP Request
body
HTTP Body
Expand HTTP Body definition...
body
Alert
Expand Alert definition...
applied_dashboard_filters
comparison_type
string
This property informs the check what kind of comparison we are performing. Only certain condition types are valid for time series alerts. For details, refer to [Setting Alert Conditions](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts#setting_alert_conditions) Valid values are: "EQUAL_TO", "GREATER_THAN", "GREATER_THAN_OR_EQUAL_TO", "LESS_THAN", "LESS_THAN_OR_EQUAL_TO", "INCREASES_BY", "DECREASES_BY", "CHANGES_BY".
cron
string
Vixie-Style crontab specification when to run. At minimum, it has to be longer than 15 minute intervals
custom_url_base
string
Domain for the custom url selected by the alert creator from the admin defined domain allowlist
custom_url_params
string
Parameters and path for the custom url defined by the alert creator
custom_url_label
string
Label for the custom url defined by the alert creator
show_custom_url
boolean
Boolean to determine if the custom url should be used
custom_title
string
An optional, user-defined title for the alert
dashboard_element_id
string
ID of the dashboard element associated with the alert. Refer to [dashboard_element()](#!/Dashboard/DashboardElement)
description
string
An optional description for the alert. This supplements the title
destinations
field
The field the alert threshold is compared against when determining when to send notifications
followed
boolean
Whether or not the user follows this alert.
followable
boolean
Whether or not the alert is followable
id
string
ID of the alert
is_disabled
boolean
Whether or not the alert is disabled
disabled_reason
string
Reason for disabling alert
is_public
boolean
Whether or not the alert is public
investigative_content_type
string
The type of the investigative content Valid values are: "dashboard".
investigative_content_id
string
The ID of the investigative content. For dashboards, this will be the dashboard ID
investigative_content_title
string
The title of the investigative content.
lookml_dashboard_id
string
ID of the LookML dashboard associated with the alert
lookml_link_id
string
ID of the LookML dashboard element associated with the alert
owner_id
string
User id of alert owner
owner_display_name
string
Alert owner's display name
threshold
number
Value of the alert threshold
time_series_condition_state
(Write-Only) (Optional) Only used when first creating time series alerts. It's used to pick a starting time reference from which alerts will be evaluated again. Without it, alerts be run against all time series data. Refer to [docs](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts) for details. Example `{ latest_time_series_id: '2020-09-17', previous_time_series_id: '2020-09-16' }`.

Response

200: The alert is saved.

Datatype
Description
(object)
applied_dashboard_filters
Expand AlertAppliedDashboardFilter definition...
filter_title
string
Field Title. Refer to `DashboardFilter.title` in [DashboardFilter](#!/types/DashboardFilter). Example `Name`
field_name
string
Field Name. Refer to `DashboardFilter.dimension` in [DashboardFilter](#!/types/DashboardFilter). Example `distribution_centers.name`
filter_value
string
Field Value. [Filter Expressions](https://cloud.google.com/looker/docs/reference/filter-expressions). Example `Los Angeles CA`
filter_description
string
Human Readable Filter Description. This may be null or auto-generated. Example `is Los Angeles CA`
comparison_type
string
This property informs the check what kind of comparison we are performing. Only certain condition types are valid for time series alerts. For details, refer to [Setting Alert Conditions](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts#setting_alert_conditions) Valid values are: "EQUAL_TO", "GREATER_THAN", "GREATER_THAN_OR_EQUAL_TO", "LESS_THAN", "LESS_THAN_OR_EQUAL_TO", "INCREASES_BY", "DECREASES_BY", "CHANGES_BY".
cron
string
Vixie-Style crontab specification when to run. At minimum, it has to be longer than 15 minute intervals
custom_url_base
string
Domain for the custom url selected by the alert creator from the admin defined domain allowlist
custom_url_params
string
Parameters and path for the custom url defined by the alert creator
custom_url_label
string
Label for the custom url defined by the alert creator
show_custom_url
boolean
Boolean to determine if the custom url should be used
custom_title
string
An optional, user-defined title for the alert
dashboard_element_id
string
ID of the dashboard element associated with the alert. Refer to [dashboard_element()](#!/Dashboard/DashboardElement)
description
string
An optional description for the alert. This supplements the title
destinations
Expand AlertDestination definition...
destination_type
string
Type of destination that the alert will be sent to Valid values are: "EMAIL", "ACTION_HUB".
email_address
string
Email address for the 'email' type
action_hub_integration_id
string
Action hub integration id for the 'action_hub' type. [Integration](#!/types/Integration)
action_hub_form_params_json
string
Action hub form params json for the 'action_hub' type [IntegrationParam](#!/types/IntegrationParam)
field
The field the alert threshold is compared against when determining when to send notifications
Expand AlertField definition...
title
string
Field's title. Usually auto-generated to reflect field name and its filters
name
string
Field's name. Has the format `.` Refer to [docs](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts) for more details
filter
Expand AlertFieldFilter definition...
field_name
string
Field Name. Has format `.`
field_value
any
Field Value. Depends on the type of field - numeric or string. For [location](https://cloud.google.com/looker/docs/reference/field-reference/dimension-type-reference#location) type, it's a list of floats. Example `[1.0, 56.0]`
filter_value
string
Filter Value. Usually null except for [location](https://cloud.google.com/looker/docs/reference/field-reference/dimension-type-reference#location) type. It'll be a string of lat,long ie `'1.0,56.0'`
followed
boolean
Whether or not the user follows this alert.
followable
boolean
Whether or not the alert is followable
id
string
ID of the alert
is_disabled
boolean
Whether or not the alert is disabled
disabled_reason
string
Reason for disabling alert
is_public
boolean
Whether or not the alert is public
investigative_content_type
string
The type of the investigative content Valid values are: "dashboard".
investigative_content_id
string
The ID of the investigative content. For dashboards, this will be the dashboard ID
investigative_content_title
string
The title of the investigative content.
lookml_dashboard_id
string
ID of the LookML dashboard associated with the alert
lookml_link_id
string
ID of the LookML dashboard element associated with the alert
owner_id
string
User id of alert owner
owner_display_name
string
Alert owner's display name
threshold
number
Value of the alert threshold
time_series_condition_state
(Write-Only) (Optional) Only used when first creating time series alerts. It's used to pick a starting time reference from which alerts will be evaluated again. Without it, alerts be run against all time series data. Refer to [docs](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts) for details. Example `{ latest_time_series_id: '2020-09-17', previous_time_series_id: '2020-09-16' }`.
Expand AlertConditionState definition...
previous_time_series_id
string
(Write-Only) The second latest time string the alert has seen.
latest_time_series_id
string
(Write-Only) Latest time string the alert has seen.

400: Bad Request

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

404: Not Found

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

405: Resource Can't Be Modified

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

409: Resource Already Exists

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

422: Validation Error

Datatype
Description
(object)
message
string
Error details
Expand ValidationErrorDetail definition...
field
string
Field with error
code
string
Error code
message
string
Error info message
documentation_url
string
Documentation link
documentation_url
string
Documentation link

429: Too Many Requests

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link