# Update a send alert

Updates the configuration of an existing send alert.

NOTE: This endpoint performs a full replacement (PUT) of the alert resource. To update specific fields like 'alert_channels' without losing existing configuration, you should first fetch the current alert object via a GET request.

Use the attributes from the existing alert to populate the request body, modifying only the 'alert_channels' array (or other desired fields) before sending the PUT request. Omitting existing attributes may result in validation errors or the loss of current settings.

Endpoint: PUT /v1/thresholds/alerts/send/{name}
Version: 3.0.0
Security: basicAuth

## Path parameters:

  - `name` (string, required)
    Threshold name that identifies this threshold

## Request fields (application/json):

  - `name` (string, required)
    A user-friendly name for the alert.

  - `metric` (string, required)
    The metric being monitored.
    Enum: "hard_bounce_rate", "temporary_fail_rate", "delivered_rate", "complained_rate"

  - `comparator` (string, required)
    The comparison operator.
    Enum: "=", "!=", "<", "<=", ">", ">="

  - `limit` (string, required)
    The threshold limit for the alert.

  - `dimension` (string, required)
    The dimension to apply to the metric.
    Enum: "domain", "ip", "ip_pool", "recipient_provider", "subaccount"

  - `alert_channels` (array)
    A list of alert channels to notify.
    Enum: "email", "slack", "webhook"

  - `filters` (array)
    A list of filters to apply to the alert.

  - `filters.dimension` (string, required)
    The dimension to filter by.
    Enum: "domain", "ip", "ip_pool", "recipient_provider", "subaccount"

  - `filters.values` (array, required)
    The dimension values to apply to filter.

  - `period` (string)
    The time period for the metric aggregation in the format of '1h' '1d'.

  - `description` (string)
    A description of what the alert does.

## Response 200 fields (application/json):

  - `message` (string, required)
    Response message

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 404 fields (application/json):

  - `message` (string, required)
    Response message

## Response default fields (application/json):

  - `message` (string, required)
    Response message