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
lock
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
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
lock
boolean
Whether or not the user follows this alert.
followable
lock
boolean
Whether or not the alert is followable
id
lock
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
lock
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
(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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# Alert\n\nVersion 4.0.25.14 (latest) \nDatatype \nDescription \n(object) \nobject \napplied_dashboard_filters \n[AlertAppliedDashboardFilter](/looker/docs/reference/looker-api/latest/types/AlertAppliedDashboardFilter)\\[\\] \nExpand AlertAppliedDashboardFilter definition... \nfilter_title \nstring \nField Title. Refer to \\`DashboardFilter.title\\` in \\[DashboardFilter\\](#!/types/DashboardFilter). Example \\`Name\\` \nfield_name \nstring \nField Name. Refer to \\`DashboardFilter.dimension\\` in \\[DashboardFilter\\](#!/types/DashboardFilter). Example \\`distribution_centers.name\\` \nfilter_value \nstring \nField Value. \\[Filter Expressions\\](https://cloud.google.com/looker/docs/reference/filter-expressions). Example \\`Los Angeles CA\\` \nfilter_description \n*lock* \nstring \nHuman Readable Filter Description. This may be null or auto-generated. Example \\`is Los Angeles CA\\` \ncomparison_type \nstring \nThis 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\". \ncron \nstring \nVixie-Style crontab specification when to run. At minimum, it has to be longer than 15 minute intervals \ncustom_url_base \nstring \nDomain for the custom url selected by the alert creator from the admin defined domain allowlist \ncustom_url_params \nstring \nParameters and path for the custom url defined by the alert creator \ncustom_url_label \nstring \nLabel for the custom url defined by the alert creator \nshow_custom_url \nboolean \nBoolean to determine if the custom url should be used \ncustom_title \nstring \nAn optional, user-defined title for the alert \ndashboard_element_id \nstring \nID of the dashboard element associated with the alert. Refer to \\[dashboard_element()\\](#!/Dashboard/DashboardElement) \ndescription \nstring \nAn optional description for the alert. This supplements the title \ndestinations \n[AlertDestination](/looker/docs/reference/looker-api/latest/types/AlertDestination)\\[\\] \nExpand AlertDestination definition... \ndestination_type \nstring \nType of destination that the alert will be sent to Valid values are: \"EMAIL\", \"ACTION_HUB\". \nemail_address \nstring \nEmail address for the 'email' type \naction_hub_integration_id \nstring \nAction hub integration id for the 'action_hub' type. \\[Integration\\](#!/types/Integration) \naction_hub_form_params_json \nstring \nAction hub form params json for the 'action_hub' type \\[IntegrationParam\\](#!/types/IntegrationParam) \nfield \n[AlertField](/looker/docs/reference/looker-api/latest/types/AlertField) \nThe field the alert threshold is compared against when determining when to send notifications\nExpand AlertField definition... \ntitle \nstring \nField's title. Usually auto-generated to reflect field name and its filters \nname \nstring \nField's name. Has the format \\`.\\` Refer to \\[docs\\](https://cloud.google.com/looker/docs/sharing-and-publishing/creating-alerts) for more details \nfilter \n[AlertFieldFilter](/looker/docs/reference/looker-api/latest/types/AlertFieldFilter)\\[\\] \nExpand AlertFieldFilter definition... \nfield_name \nstring \nField Name. Has format \\`.\\` \nfield_value \nany \nField 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\\]\\` \nfilter_value \nstring \nFilter 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'\\` \nfollowed \n*lock* \nboolean \nWhether or not the user follows this alert. \nfollowable \n*lock* \nboolean \nWhether or not the alert is followable \nid \n*lock* \nstring \nID of the alert \nis_disabled \nboolean \nWhether or not the alert is disabled \ndisabled_reason \nstring \nReason for disabling alert \nis_public \nboolean \nWhether or not the alert is public \ninvestigative_content_type \nstring \nThe type of the investigative content Valid values are: \"dashboard\". \ninvestigative_content_id \nstring \nThe ID of the investigative content. For dashboards, this will be the dashboard ID \ninvestigative_content_title \n*lock* \nstring \nThe title of the investigative content. \nlookml_dashboard_id \nstring \nID of the LookML dashboard associated with the alert \nlookml_link_id \nstring \nID of the LookML dashboard element associated with the alert \nowner_id \nstring \nUser id of alert owner \nowner_display_name \n*lock* \nstring \nAlert owner's display name \nthreshold \nnumber \nValue of the alert threshold \ntime_series_condition_state \n[AlertConditionState](/looker/docs/reference/looker-api/latest/types/AlertConditionState) \n(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' }\\`.\nExpand AlertConditionState definition... \nprevious_time_series_id \nstring \n(Write-Only) The second latest time string the alert has seen. \nlatest_time_series_id \nstring \n(Write-Only) Latest time string the alert has seen.\n\nRelated Methods\n---------------\n\n- [Alert/get_alert](../methods/Alert/get_alert \"Alert/get_alert\")\n- [Alert/update_alert_field](../methods/Alert/update_alert_field \"Alert/update_alert_field\")\n- [Alert/update_alert](../methods/Alert/update_alert \"Alert/update_alert\")\n- [Alert/create_alert](../methods/Alert/create_alert \"Alert/create_alert\")"]]
