FLflightaware
alerts

Modify specific alert

Modifies the configuration for an alert with the specified ID. If a target URL address is provided, then the alert will be delivered to that address even if it is different than the default account-wide address set through the alerts/endpoint endpoint. Updating an alert that was created with a different AeroAPI key is possible, but will not change the AeroAPI key that the alert is associated with for usage.

put/alerts/{id}

Request

Request body

identstring nullable required

Ident to alert on. This value may be modified based on codeshare resolution. If that occurs, the originally provided ident will be preserved in the user_ident field.

originstring nullable required

Origin airport ICAO, IATA, or LID code to alert on.

destinationstring nullable required

Destination airport ICAO, IATA, or LID code to alert on.

aircraft_typestring nullable required

Aircraft type ICAO code to alert on.

startstring date nullable required

Start date of alert. Should be in departure airport's timezone.

endstring date nullable required

End date of alert (inclusive). Should be in departure airport's timezone.

max_weeklyinteger

Reject the new alert if the estimated number of triggered alerts per week based on historical flight trends would exceed this value. The threshold only considers alerts triggered by this alert config (it is not a total for all previously configured alerts). Check is only applied at alert creation/modification, and does and does not prevent alerts from being delivered even if they exceed the given amount. If your alert request is rejected, consider adding additional filter criteria for the alert creation to further refine the config. If max_weekly is not specified for a standard customer, we default the max_weekly to 1000. For a premium customer, we default the max_weekly to 4000.

etainteger required

How many minutes before a flight's ETA that an alert should be delivered. Alerts will only be delivered after the flight has been in the air for at least 15 minutes. Set to 0 to disable.

target_urlstring nullable required

Alert specific URL to deliver to. If null, then the alert will be delivered to the configured account-wide alert URL target.

enabledboolean required

Whether alert is enabled.

Response

Alert modified

Changes

No recorded changes to this operation across all 1 revision of this API.