Version 4.0.24.14
Search Alerts
Request
GET
/alerts/search
Datatype
Description
Request
query
Expand HTTP Query definition...
limit
(Optional) Number of results to return (used with `offset`).
offset
(Optional) Number of results to skip before returning any (used with `limit`).
group_by
(Optional) Dimension by which to order the results(`dashboard` | `owner`)
fields
(Optional) Requested fields.
disabled
(Optional) Filter on returning only enabled or disabled alerts.
frequency
(Optional) Filter on alert frequency, such as: monthly, weekly, daily, hourly, minutes
condition_met
(Optional) Filter on whether the alert has met its condition when it last executed
last_run_start
(Optional) Filter on the start range of the last time the alerts were run. Example: 2021-01-01T01:01:01-08:00.
last_run_end
(Optional) Filter on the start range of the last time the alerts were run. Example: 2021-01-01T01:01:01-08:00.
all_owners
(Admin only) (Optional) Filter for all owners.
Response
200: Alert.
Datatype
Description
(array)
applied_dashboard_filters
Expand AlertAppliedDashboardFilter definition...
filter_title
Field Title. Refer to `DashboardFilter.title` in [DashboardFilter](#!/types/DashboardFilter). Example `Name`
field_name
Field Name. Refer to `DashboardFilter.dimension` in [DashboardFilter](#!/types/DashboardFilter). Example `distribution_centers.name`
filter_value
Field Value. [Filter Expressions](https://cloud.google.com/looker/docs/reference/filter-expressions). Example `Los Angeles CA`
filter_description
lock
Human Readable Filter Description. This may be null or auto-generated. Example `is Los Angeles CA`
comparison_type
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
Vixie-Style crontab specification when to run. At minimum, it has to be longer than 15 minute intervals
custom_url_base
Domain for the custom url selected by the alert creator from the admin defined domain allowlist
custom_url_params
Parameters and path for the custom url defined by the alert creator
custom_url_label
Label for the custom url defined by the alert creator
show_custom_url
Boolean to determine if the custom url should be used
custom_title
An optional, user-defined title for the alert
dashboard_element_id
ID of the dashboard element associated with the alert. Refer to [dashboard_element()](#!/Dashboard/DashboardElement)
description
An optional description for the alert. This supplements the title
destinations
Expand AlertDestination definition...
destination_type
Type of destination that the alert will be sent to Valid values are: "EMAIL", "ACTION_HUB".
email_address
Email address for the 'email' type
action_hub_integration_id
Action hub integration id for the 'action_hub' type. [Integration](#!/types/Integration)
action_hub_form_params_json
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
Field's title. Usually auto-generated to reflect field name and its filters
name
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
Field Name. Has format `.`
field_value
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
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
lock
Whether or not the user follows this alert.
followable
lock
Whether or not the alert is followable
id
lock
ID of the alert
is_disabled
Whether or not the alert is disabled
disabled_reason
Reason for disabling alert
is_public
Whether or not the alert is public
investigative_content_type
The type of the investigative content Valid values are: "dashboard".
investigative_content_id
The ID of the investigative content. For dashboards, this will be the dashboard ID
investigative_content_title
lock
The title of the investigative content.
lookml_dashboard_id
ID of the LookML dashboard associated with the alert
lookml_link_id
ID of the LookML dashboard element associated with the alert
owner_id
User id of alert owner
owner_display_name
lock
Alert owner's display name
threshold
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
(Write-Only) The second latest time string the alert has seen.
latest_time_series_id
(Write-Only) Latest time string the alert has seen.
400: Bad Request
Datatype
Description
(object)
message
lock
Error details
documentation_url
lock
Documentation link
403: Permission Denied
Datatype
Description
(object)
message
lock
Error details
documentation_url
lock
Documentation link
404: Not Found
Datatype
Description
(object)
message
lock
Error details
documentation_url
lock
Documentation link
429: Too Many Requests
Datatype
Description
(object)
message
lock
Error details
documentation_url
lock
Documentation link