[[["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,["# Update select fields on an alert\n\nVersion 4.0.25.14 (latest)\n\n### Update select alert fields\n\nAvailable fields: `owner_id`, `is_disabled`, `disabled_reason`, `is_public`, `threshold`\n========================================================================================\n\nRequest\n-------\n\nPATCH /alerts/{alert_id} \nDatatype \nDescription \nRequest \nHTTP Request \npath \nHTTP Path \nExpand HTTP Path definition... \nalert_id \nstring \nID of an alert \nbody \nHTTP Body \nExpand HTTP Body definition... \nbody \n[AlertPatch](/looker/docs/reference/looker-api/latest/types/AlertPatch) \nAlert\nExpand AlertPatch definition... \nowner_id \nstring \nNew owner ID of the alert \nis_disabled \nboolean \nSet alert enabled or disabled \ndisabled_reason \nstring \nThe reason this alert is disabled \nis_public \nboolean \nSet alert public or private \nthreshold \nnumber \nNew threshold value\n\nResponse\n--------\n\n### 200: The alert is saved.\n\nDatatype \nDescription \n(object) \n[Alert](/looker/docs/reference/looker-api/latest/types/Alert) \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\n### 400: Bad Request\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 403: Permission Denied\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 404: Not Found\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 422: Validation Error\n\nDatatype \nDescription \n(object) \n[ValidationError](/looker/docs/reference/looker-api/latest/types/ValidationError) \nmessage \n*lock* \nstring \nError details \nerrors \n[ValidationErrorDetail](/looker/docs/reference/looker-api/latest/types/ValidationErrorDetail)\\[\\] \nExpand ValidationErrorDetail definition... \nfield \n*lock* \nstring \nField with error \ncode \n*lock* \nstring \nError code \nmessage \n*lock* \nstring \nError info message \ndocumentation_url \n*lock* \nstring \nDocumentation link \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 429: Too Many Requests\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link"]]
