# Update an Alert

Updates an existing alert's threshold, method, or recipient groups. All updatable fields follow the same schema as POST /alerts.

Endpoint: PUT /api/v1/alerts/{alert_id}
Security: BearerAuth

## Path parameters:

  - `alert_id` (number, required)
    ID of the alert.
    Example: "42"

## Request fields (application/json):

  - `type` (string)
    Quantity fires when an item's stock crosses a threshold. DateReminder fires relative to a date held in a datetime custom field. Change this to convert an alert from one to the other.
    Enum: "Quantity", "DateReminder"

  - `item_id` (number, required)
    The item the alert watches. Required on every update, whatever the alert's type and even when you are only moving a threshold. Leave it out and the request is rejected with 422. On a DateReminder it pairs with custom_attribute_id: together they identify whose field value to watch, so it is not redundant there. Change it to point the alert at a different item.
    Example: 12345

  - `custom_attribute_id` (number,null)
    For a DateReminder, the datetime custom field the alert watches.

  - `threshold_method` (string)
    What triggers the alert. Use a quantity_* method (or less_than_or_equal_to_min_quantity) with type: Quantity, and before, after or same_day with type: DateReminder.
    Enum: "less_than_or_equal_to_min_quantity", "quantity_greater_than", "quantity_less_than", "quantity_less_than_equal_to", "quantity_greater_than_equal_to", "before", "after", "same_day"

  - `threshold_value` (number)
    The number the alert is compared against.
    Example: 5

  - `threshold_interval` (string,null)
    How far before or after the date to fire. Required for DateReminder alerts, null for Quantity.
    Enum: "days", "weeks", "months", "years", null

  - `recipient_groups` (array)
    Who gets notified when the alert fires.
    Enum: "owners", "admins", "members"

## Response 201 fields (application/json):

  - `data` (object)

  - `data.id` (number)

  - `data.threshold_method` (string)

  - `data.threshold_value` (number)

  - `data.threshold_interval` (string)

  - `data.is_fired` (boolean,null)

  - `data.triggerable_type` (string)

  - `data.triggerable_id` (number)

  - `data.type` (string)

  - `data.is_deleted` (boolean)

  - `data.recipient_groups` (array)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)