Skip to main content

Update alert​

This endpoint updates the thresholds of an alert.

Path Parameters
    alert_configuration_id string required
Request Body required
    thresholds object[] required

    The thresholds that define the values at which the alert will be triggered.

  • Array [
    • value number required

    The value at which an alert will fire. For credit balance alerts, the alert will fire at or below this value. For usage and cost alerts, the alert will fire at or above this value.

  • ]
Responses

OK

Response Headers
    Schema
      id string required

      Also referred to as alert_id in this documentation.

      type string required

      Possible values: [usage_exceeded, cost_exceeded, credit_balance_depleted, credit_balance_dropped, credit_balance_recovered]

      The type of alert. This must be a valid alert type.

      created_at date-time required

      The creation time of the resource in Orb.

      enabled boolean required

      Whether the alert is enabled or disabled.

      thresholds object[] nullable required

      The thresholds that define the conditions under which the alert will be triggered.

    • Array [
      • value number required

      The value at which an alert will fire. For credit balance alerts, the alert will fire at or below this value. For usage and cost alerts, the alert will fire at or above this value.

    • ]
      • customer object nullable required

      The customer the alert applies to.

      id string required
      external_customer_id string nullable required
      plan object nullable required

      The plan the alert applies to.

      id string nullable required
      external_plan_id string nullable required

      An optional user-defined ID for this plan resource, used throughout the system as an alias for this Plan. Use this field to identify a plan by an existing identifier in your system.

      name string nullable required
      plan_version string required
      subscription object nullable required

      The subscription the alert applies to.

      id string required
      metric object nullable required

      The metric the alert applies to.

      id string required
      currency string nullable required

      The name of the currency the credit balance or invoice cost is denominated in.

    Loading...