@metronome/sdk 1.0.0 → 2.0.0

package/src/resources/v1/alerts.ts

@@ -7,16 +7,15 @@ import { RequestOptions } from '../../internal/request-options';
 
 export class Alerts extends APIResource {
   /**
-   * Create a new alert to monitor customer spending, balances, and billing metrics
-   * in real-time. Metronome's alert system provides industry-leading speed with
-   * immediate evaluation capabilities, enabling you to proactively manage customer
-   * accounts and prevent revenue leakage.
+   * Create a new threshold notification to monitor customer spending, balances, and
+   * billing metrics in real-time. Metronome's notification system provides
+   * industry-leading speed with immediate evaluation capabilities, enabling you to
+   * proactively manage customer accounts and prevent revenue leakage.
    *
-   * This endpoint creates configurable alerts that continuously monitor various
-   * billing thresholds including spend limits, credit balances, commitment
-   * utilization, and invoice totals. Alerts can be configured globally for all
-   * customers or targeted to specific customer accounts. Custom fields can be used
-   * on certain alert types to further target alerts to groups of customers.
+   * This endpoint creates configurable threshold notifications that continuously
+   * monitor various billing thresholds including spend limits, credit balances,
+   * commitment utilization, and invoice totals. Threshold notifications can be
+   * configured globally for all customers or targeted to specific customer accounts.
    *
    * ### Use this endpoint to:
    *
@@ -32,26 +31,27 @@ export class Alerts extends APIResource {
    *
    * A successful response returns a CustomerAlert object containing:
    *
-   * - The alert configuration with its unique ID and current status
+   * - The threshold notification configuration with its unique ID and current status
    * - The customer's evaluation status (ok, in_alarm, or evaluating)
-   * - Alert metadata including type, threshold values, and update timestamps
+   * - Threshold notification metadata including type, threshold values, and update
+   *   timestamps
    *
    * ### Usage guidelines:
    *
    * - Immediate evaluation: Set `evaluate_on_create` : `true` (default) for instant
    *   evaluation against existing customers
-   * - Uniqueness constraints: Each alert must have a unique `uniqueness_key` within
-   *   your organization. Use `release_uniqueness_key` : `true` when archiving to
-   *   reuse keys
-   * - Alert type requirements: Different alert types require specific fields (e.g.,
-   *   `billable_metric_id` for usage alerts, `credit_type_id` for credit-based
-   *   alerts)
-   * - Webhook delivery: Alerts trigger webhook notifications for real-time
-   *   integration with your systems. Configure webhook endpoints before creating
-   *   alerts
-   * - Performance at scale: Metronome's event-driven architecture processes alert
-   *   evaluations in real-time as usage events stream in, unlike competitors who
-   *   rely on periodic polling or batch evaluation cycles
+   * - Uniqueness constraints: Each threshold notification must have a unique
+   *   `uniqueness_key` within your organization. Use `release_uniqueness_key` :
+   *   `true` when archiving to reuse keys
+   * - Notification type requirements: Different threshold notification types require
+   *   specific fields (e.g., `billable_metric_id` for usage notifications,
+   *   `credit_type_id` for credit-based threshold notifications)
+   * - Webhook delivery: Threshold notifications trigger webhook notifications for
+   *   real-time integration with your systems. Configure webhook endpoints before
+   *   creating threshold notifications
+   * - Performance at scale: Metronome's event-driven architecture processes
+   *   threshold notification evaluations in real-time as usage events stream in,
+   *   unlike competitors who rely on periodic polling or batch evaluation cycles
    *
    * @example
    * ```ts
@@ -70,33 +70,34 @@ export class Alerts extends APIResource {
   }
 
   /**
-   * Permanently disable an alert and remove it from active monitoring across all
-   * customers. Archived alerts stop evaluating immediately and can optionally
-   * release their uniqueness key for reuse in future alert configurations.
+   * Permanently disable a threshold notification and remove it from active
+   * monitoring across all customers. Archived threshold notifications stop
+   * evaluating immediately and can optionally release their uniqueness key for reuse
+   * in future threshold notification configurations.
    *
    * ### Use this endpoint to:
    *
-   * - Decommission alerts that are no longer needed
-   * - Clean up test or deprecated alert configurations
-   * - Free up uniqueness keys for reuse with new alerts
-   * - Stop alert evaluations without losing historical configuration data
+   * - Decommission threshold notifications that are no longer needed
+   * - Clean up test or deprecated threshold notification configurations
+   * - Free up uniqueness keys for reuse with new threshold notifications
+   * - Stop threshold notification evaluations without losing historical
+   *   configuration data
    * - Disable outdated monitoring rules during pricing model transitions
    *
    * ### Key response fields:
    *
-   * - data: Object containing the archived alert's ID
-   * - Alert evaluation stops immediately for all affected customers
-   * - Historical alert data and configurations remain accessible for audit purposes
+   * - data: Object containing the archived threshold notification's ID
    *
    * ### Usage guidelines:
    *
-   * - Irreversible for evaluation: Archived alerts cannot be re-enabled; create a
-   *   new alert to resume monitoring
+   * - Irreversible for evaluation: Archived threshold notifications cannot be
+   *   re-enabled; create a new threshold notification to resume monitoring
    * - Uniqueness key handling: Set `release_uniqueness_key` : `true` to reuse the
-   *   key in future alerts
-   * - Immediate effect: Alert evaluation stops instantly across all customers
-   * - Historical preservation: Archive operation maintains alert history and
-   *   configuration for compliance and auditing
+   *   key in future threshold notifications
+   * - Immediate effect: Threshold notification evaluation stops instantly across all
+   *   customers
+   * - Historical preservation: Archive operation maintains threshold notification
+   *   history and configuration for compliance and auditing
    *
    * @example
    * ```ts
@@ -120,7 +121,7 @@ export interface AlertArchiveResponse {
 
 export interface AlertCreateParams {
   /**
-   * Type of the alert
+   * Type of the threshold notification
    */
   alert_type:
     | 'low_credit_balance_reached'
@@ -139,70 +140,72 @@ export interface AlertCreateParams {
     | 'invoice_total_reached';
 
   /**
-   * Name of the alert
+   * Name of the threshold notification
    */
   name: string;
 
   /**
-   * Threshold value of the alert policy. Depending upon the alert type, this number
-   * may represent a financial amount, the days remaining, or a percentage reached.
+   * Threshold value of the notification policy. Depending upon the notification
+   * type, this number may represent a financial amount, the days remaining, or a
+   * percentage reached.
    */
   threshold: number;
 
   /**
-   * For alerts of type `usage_threshold_reached`, specifies which billable metric to
-   * track the usage for.
+   * For threshold notifications of type `usage_threshold_reached`, specifies which
+   * billable metric to track the usage for.
    */
   billable_metric_id?: string;
 
   /**
-   * An array of strings, representing a way to filter the credit grant this alert
-   * applies to, by looking at the credit_grant_type field on the credit grant. This
-   * field is only defined for CreditPercentage and CreditBalance alerts
+   * An array of strings, representing a way to filter the credit grant this
+   * threshold notification applies to, by looking at the credit_grant_type field on
+   * the credit grant. This field is only defined for CreditPercentage and
+   * CreditBalance notifications
    */
   credit_grant_type_filters?: Array<string>;
 
   /**
-   * ID of the credit's currency, defaults to USD. If the specific alert type
+   * ID of the credit's currency, defaults to USD. If the specific notification type
    * requires a pricing unit/currency, find the ID in the
    * [Metronome app](https://app.metronome.com/offering/pricing-units).
    */
   credit_type_id?: string;
 
   /**
-   * A list of custom field filters for alert types that support advanced filtering.
-   * Only present for contract invoices.
+   * A list of custom field filters for threshold notification types that support
+   * advanced filtering. Only present for contract invoices.
    */
   custom_field_filters?: Array<AlertCreateParams.CustomFieldFilter>;
 
   /**
-   * If provided, will create this alert for this specific customer. To create an
-   * alert for all customers, do not specify a `customer_id`.
+   * If provided, will create this threshold notification for this specific customer.
+   * To create a notification for all customers, do not specify a `customer_id`.
    */
   customer_id?: string;
 
   /**
-   * If true, the alert will evaluate immediately on customers that already meet the
-   * alert threshold. If false, it will only evaluate on future customers that
-   * trigger the alert threshold. Defaults to true.
+   * If true, the threshold notification will evaluate immediately on customers that
+   * already meet the notification threshold. If false, it will only evaluate on
+   * future customers that trigger the threshold. Defaults to true.
    */
   evaluate_on_create?: boolean;
 
   /**
-   * Only present for `spend_threshold_reached` alerts. Scope alert to a specific
-   * group key on individual line items.
+   * Only present for `spend_threshold_reached` notifications. Scope notification to
+   * a specific group key on individual line items.
    */
   group_values?: Array<AlertCreateParams.GroupValue>;
 
   /**
-   * Only supported for invoice_total_reached alerts. A list of invoice types to
-   * evaluate.
+   * Only supported for invoice_total_reached threshold notifications. A list of
+   * invoice types to evaluate.
    */
   invoice_types_filter?: Array<string>;
 
   /**
-   * If provided, will create this alert for this specific plan. To create an alert
-   * for all customers, do not specify a `plan_id`.
+   * If provided, will create this threshold notification for this specific plan. To
+   * create a notification for all customers, do not specify a `plan_id`.
    */
   plan_id?: string;
 
@@ -232,12 +235,13 @@ export namespace AlertCreateParams {
 
 export interface AlertArchiveParams {
   /**
-   * The Metronome ID of the alert
+   * The Metronome ID of the threshold notification
    */
   id: string;
 
   /**
-   * If true, resets the uniqueness key on this alert so it can be re-used
+   * If true, resets the uniqueness key on this threshold notification so it can be
+   * re-used
    */
   release_uniqueness_key?: boolean;
 }

package/src/resources/v1/contracts/contracts.ts

@@ -574,11 +574,12 @@ export class Contracts extends APIResource {
   }
 
   /**
-   * Update or and an end date to a contract. Ending a contract early will impact
+   * Update or add an end date to a contract. Ending a contract early will impact
    * draft usage statements, truncate any terms, and remove upcoming scheduled
    * invoices. Moving the date into the future will only extend the contract length.
-   * Terms and scheduled invoices are not extended. Use this if a contract's end date
-   * has changed or if a perpetual contract ends.
+   * Terms and scheduled invoices are not extended. In-advance subscriptions will not
+   * be extended. Use this if a contract's end date has changed or if a perpetual
+   * contract ends.
    *
    * @example
    * ```ts
@@ -1117,7 +1118,7 @@ export namespace ContractCreateParams {
        * not wish Metronome to calculate tax on your behalf. Leaving this field blank
        * will default to NONE.
        */
-      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
     }
 
     export namespace PaymentGateConfig {
@@ -1387,7 +1388,22 @@ export namespace ContractCreateParams {
   }
 
   export interface HierarchyConfiguration {
-    parent: HierarchyConfiguration.Parent;
+    parent?: HierarchyConfiguration.Parent;
+
+    parent_behavior?: HierarchyConfiguration.ParentBehavior;
+
+    /**
+     * Indicates whether the parent should pay for the child's invoice charges
+     */
+    payer?: 'SELF' | 'PARENT';
+
+    /**
+     * Indicates the behavior of the child's invoice statements on the parent's
+     * invoices **CONSOLIDATE**: Child's invoice statements will be added to parent's
+     * consolidated invoices **SEPARATE**: Child's invoice statements will appear not
+     * appear on parent's consolidated invoices
+     */
+    usage_statement_behavior?: 'CONSOLIDATE' | 'SEPARATE';
   }
 
   export namespace HierarchyConfiguration {
@@ -1396,6 +1412,16 @@ export namespace ContractCreateParams {
 
       customer_id: string;
     }
+
+    export interface ParentBehavior {
+      /**
+       * Indicates the desired behavior of consolidated invoices generated by the parent
+       * in a customer hierarchy **CONCATENATE**: Statements on the invoices of child
+       * customers will be appended to the consolidated invoice **NONE**: Do not generate
+       * consolidated invoices
+       */
+      invoice_consolidation_type?: 'CONCATENATE' | 'NONE';
+    }
   }
 
   export interface Override {
@@ -2648,7 +2674,7 @@ export namespace ContractAmendParams {
        * not wish Metronome to calculate tax on your behalf. Leaving this field blank
        * will default to NONE.
        */
-      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'PRECALCULATED';
+      tax_type?: 'NONE' | 'STRIPE' | 'ANROK' | 'AVALARA' | 'PRECALCULATED';
     }
 
     export namespace PaymentGateConfig {

package/src/resources/v1/customers/alerts.ts

@@ -13,17 +13,26 @@ import { RequestOptions } from '../../../internal/request-options';
 
 export class Alerts extends APIResource {
   /**
-   * Retrieve the real-time evaluation status for a specific alert-customer pair.
-   * This endpoint provides instant visibility into whether a customer has triggered
-   * an alert condition, enabling you to monitor account health and take proactive
-   * action based on current alert states.
+   * Retrieve the real-time evaluation status for a specific threshold
+   * notification-customer pair. This endpoint provides instant visibility into
+   * whether a customer has triggered a threshold notification condition, enabling
+   * you to monitor account health and take proactive action based on current
+   * threshold notification states.
    *
    * ### Use this endpoint to:
    *
-   * - Check if a specific customer is currently violating an alert threshold
+   * - Check if a specific customer is currently violating an threshold notification
    *   (`in_alarm` status)
-   * - Verify alert configuration details and threshold values for a customer
-   * - Integrate alert status checks into customer support tools or admin interfaces
+   * - Verify threshold notification configuration details and threshold values for a
+   *   customer
+   * - Monitor the evaluation state of newly created or recently modified threshold
+   *   notification
+   * - Build dashboards or automated workflows that respond to specific threshold
+   *   notification conditions
+   * - Validate threshold notification behavior before deploying to production
+   *   customers
+   * - Integrate threshold notification status checks into customer support tools or
+   *   admin interfaces
    *
    * ### Key response fields:
    *
@@ -32,29 +41,32 @@ export class Alerts extends APIResource {
    * - `customer_status`: The current evaluation state
    *
    * - `ok` - Customer is within acceptable thresholds
-   * - `in_alarm`- Customer has breached the alert threshold
-   * - `evaluating` - Alert has yet to be evaluated (typically due to a customer or
-   *   alert having just been created)
-   * - `null` - Alert has been archived
-   * - `triggered_by`: Additional context about what caused the alert to trigger
-   *   (when applicable)
-   * - alert: Complete alert configuration including:
-   *   - Alert ID, name, and type
+   * - `in_alarm` - Customer has breached the threshold for the notification
+   * - `evaluating` - Notification is currently being evaluated (typically during
+   *   initial setup)
+   * - `null` - Notification has been archived
+   * - `triggered_by`: Additional context about what caused the notification to
+   *   trigger (when applicable)
+   * - alert: Complete threshold notification configuration including:
+   *   - Notification ID, name, and type
    *   - Current threshold values and credit type information
-   *   - Alert status (enabled, disabled, or archived)
+   *   - Notification status (enabled, disabled, or archived)
    *   - Last update timestamp
    *   - Any applied filters (credit grant types, custom fields, group values)
    *
    * ### Usage guidelines:
    *
    * - Customer status: Returns the current evaluation state, not historical data.
-   *   For alert history, use webhook notifications or event logs
-   * - Archived alerts: Returns null for customer_status if the alert has been
-   *   archived, but still includes the alert configuration details
-   * - Integration patterns: This endpoint can be used to check a customer's alert
-   *   status, but shouldn't be scraped. You should instead rely on the webhook
-   *   notification to understand when customers are moved to IN_ALARM.
-   * - Error handling: Returns 404 if either the customer or alert ID doesn't exist
+   *   For threshold notification history, use webhook notifications or event logs
+   * - Required parameters: Both customer_id and alert_id must be valid UUIDs that
+   *   exist in your organization
+   * - Archived notifications: Returns null for customer_status if the notification
+   *   has been archived, but still includes the notification configuration details
+   * - Performance considerations: This endpoint queries live evaluation state,
+   *   making it ideal for real-time monitoring but not for bulk status checks
+   * - Integration patterns: Best used for on-demand status checks in response to
+   *   user actions or as part of targeted monitoring workflows
+   * - Error handling: Returns 404 if either the customer or alert_id doesn't exist
    *   or isn't accessible to your organization
    *
    * @example
@@ -70,31 +82,37 @@ export class Alerts extends APIResource {
   }
 
   /**
-   * Retrieve all alert configurations and their current statuses for a specific
-   * customer in a single API call. This endpoint provides a comprehensive view of
-   * all alerts monitoring a customer account.
+   * Retrieve all threshold notification configurations and their current statuses
+   * for a specific customer in a single API call. This endpoint provides a
+   * comprehensive view of all threshold notification monitoring a customer account.
    *
    * ### Use this endpoint to:
    *
-   * - Display all active alerts for a customer in dashboards or admin panels
-   * - Quickly identify which alerts a customer is currently triggering
-   * - Audit alert coverage for specific accounts
-   * - Filter alerts by status (enabled, disabled, or archived)
+   * - Display all active threshold notifications for a customer in dashboards or
+   *   admin panels
+   * - Quickly identify which threshold notifications a customer is currently
+   *   triggering
+   * - Audit threshold notification coverage for specific accounts
+   * - Filter threshold notifications by status (enabled, disabled, or archived)
    *
    * ### Key response fields:
    *
    * - data: Array of CustomerAlert objects, each containing:
    *   - Current evaluation status (`ok`, `in_alarm`, `evaluating`, or `null`)
-   *   - Complete alert configuration and threshold details
-   *   - Alert metadata including type, name, and last update time
-   * - `next_page`: Pagination cursor for retrieving additional results
+   *   - Complete threshold notification configuration and threshold details
+   *   - Threshold notification metadata including type, name, and last update time
+   * - next_page: Pagination cursor for retrieving additional results
    *
    * ### Usage guidelines:
    *
-   * - Default behavior: Returns only enabled alerts unless alert_statuses filter is
-   *   specified
+   * - Default behavior: Returns only enabled threshold notifications unless
+   *   `alert_statuses` filter is specified
    * - Pagination: Use the `next_page` cursor to retrieve all results for customers
-   *   with many alerts
+   *   with many notifications
+   * - Performance: Efficiently retrieves multiple threshold notification statuses in
+   *   a single request instead of making individual calls
+   * - Filtering: Pass the `alert_statuses` array to include disabled or archived
+   *   threshold notifications in results
    *
    * @example
    * ```ts
@@ -120,23 +138,24 @@ export class Alerts extends APIResource {
   }
 
   /**
-   * Force an immediate re-evaluation of a specific alert for a customer, clearing
-   * any previous state and triggering a fresh assessment against current thresholds.
-   * This endpoint ensures alert accuracy after configuration changes or data
-   * corrections.
+   * Force an immediate re-evaluation of a specific threshold notification for a
+   * customer, clearing any previous state and triggering a fresh assessment against
+   * current thresholds. This endpoint ensures threshold notification accuracy after
+   * configuration changes or data corrections.
    *
    * ### Use this endpoint to:
    *
-   * - Clear false positive alerts after fixing data issues
-   * - Re-evaluate alerts after adjusting customer balances or credits
-   * - Test alert behavior during development and debugging
-   * - Resolve stuck alerts that may be in an incorrect state
+   * - Clear false positive threshold notifications after fixing data issues
+   * - Re-evaluate threshold notifications after adjusting customer balances or
+   *   credits
+   * - Test threshold notification behavior during development and debugging
+   * - Resolve stuck threshold notification that may be in an incorrect state
    * - Trigger immediate evaluation after threshold modifications
    *
    * ### Key response fields:
    *
-   * - 200 Success: Confirmation that the alert has been reset and re-evaluation
-   *   initiated
+   * - 200 Success: Confirmation that the threshold notification has been reset and
+   *   re-evaluation initiated
    * - No response body is returned - the operation completes asynchronously
    *
    * ### Usage guidelines:
@@ -172,13 +191,13 @@ export interface CustomerAlert {
   alert: CustomerAlert.Alert;
 
   /**
-   * The status of the customer alert. If the alert is archived, null will be
-   * returned.
+   * The status of the threshold notification. If the notification is archived, null
+   * will be returned.
    */
   customer_status: 'ok' | 'in_alarm' | 'evaluating' | null;
 
   /**
-   * If present, indicates the reason the alert was triggered.
+   * If present, indicates the reason the threshold notification was triggered.
    */
   triggered_by?: string | null;
 }
@@ -186,27 +205,27 @@ export interface CustomerAlert {
 export namespace CustomerAlert {
   export interface Alert {
     /**
-     * the Metronome ID of the alert
+     * the Metronome ID of the threshold notification
      */
     id: string;
 
     /**
-     * Name of the alert
+     * Name of the threshold notification
      */
     name: string;
 
     /**
-     * Status of the alert
+     * Status of the threshold notification
      */
     status: 'enabled' | 'archived' | 'disabled';
 
     /**
-     * Threshold value of the alert policy
+     * Threshold value of the notification policy
      */
     threshold: number;
 
     /**
-     * Type of the alert
+     * Type of the threshold notification
      */
     type:
       | 'low_credit_balance_reached'
@@ -225,39 +244,41 @@ export namespace CustomerAlert {
       | 'invoice_total_reached';
 
     /**
-     * Timestamp for when the alert was last updated
+     * Timestamp for when the threshold notification was last updated
      */
     updated_at: string;
 
     /**
-     * An array of strings, representing a way to filter the credit grant this alert
-     * applies to, by looking at the credit_grant_type field on the credit grant. This
-     * field is only defined for CreditPercentage and CreditBalance alerts
+     * An array of strings, representing a way to filter the credit grant this
+     * threshold notification applies to, by looking at the credit_grant_type field on
+     * the credit grant. This field is only defined for CreditPercentage and
+     * CreditBalance notifications
      */
     credit_grant_type_filters?: Array<string>;
 
     credit_type?: Shared.CreditTypeData | null;
 
     /**
-     * A list of custom field filters for alert types that support advanced filtering
+     * A list of custom field filters for notification types that support advanced
+     * filtering
      */
     custom_field_filters?: Array<Alert.CustomFieldFilter>;
 
     /**
-     * Scopes alert evaluation to a specific presentation group key on individual line
-     * items. Only present for spend alerts.
+     * Scopes threshold notification evaluation to a specific presentation group key on
+     * individual line items. Only present for spend notifications.
      */
     group_key_filter?: Alert.GroupKeyFilter;
 
     /**
-     * Only present for `spend_threshold_reached` alerts. Scope alert to a specific
-     * group key on individual line items.
+     * Only present for `spend_threshold_reached` notifications. Scope notification to
+     * a specific group key on individual line items.
      */
     group_values?: Array<Alert.GroupValue>;
 
     /**
-     * Only supported for invoice_total_reached alerts. A list of invoice types to
-     * evaluate.
+     * Only supported for invoice_total_reached threshold notifications. A list of
+     * invoice types to evaluate.
      */
     invoice_types_filter?: Array<string>;
 
@@ -279,8 +300,8 @@ export namespace CustomerAlert {
     }
 
     /**
-     * Scopes alert evaluation to a specific presentation group key on individual line
-     * items. Only present for spend alerts.
+     * Scopes threshold notification evaluation to a specific presentation group key on
+     * individual line items. Only present for spend notifications.
      */
     export interface GroupKeyFilter {
       key: string;
@@ -302,7 +323,7 @@ export interface AlertRetrieveResponse {
 
 export interface AlertRetrieveParams {
   /**
-   * The Metronome ID of the alert
+   * The Metronome ID of the threshold notification
    */
   alert_id: string;
 
@@ -312,22 +333,22 @@ export interface AlertRetrieveParams {
   customer_id: string;
 
   /**
-   * Only present for `spend_threshold_reached` alerts. Retrieve the alert for a
-   * specific group key-value pair.
+   * Only present for `spend_threshold_reached` notifications. Retrieve the
+   * notification for a specific group key-value pair.
    */
   group_values?: Array<AlertRetrieveParams.GroupValue>;
 
   /**
-   * When parallel alerts are enabled during migration, this flag denotes whether to
-   * fetch alerts for plans or contracts.
+   * When parallel threshold notifications are enabled during migration, this flag
+   * denotes whether to fetch notifications for plans or contracts.
    */
   plans_or_contracts?: 'PLANS' | 'CONTRACTS';
 }
 
 export namespace AlertRetrieveParams {
   /**
-   * Scopes alert evaluation to a specific presentation group key on individual line
-   * items. Only present for spend alerts.
+   * Scopes threshold notification evaluation to a specific presentation group key on
+   * individual line items. Only present for spend notifications.
    */
   export interface GroupValue {
     key: string;
@@ -343,15 +364,15 @@ export interface AlertListParams extends CursorPageWithoutLimitParams {
   customer_id: string;
 
   /**
-   * Body param: Optionally filter by alert status. If absent, only enabled alerts
-   * will be returned.
+   * Body param: Optionally filter by threshold notification status. If absent, only
+   * enabled notifications will be returned.
    */
   alert_statuses?: Array<'ENABLED' | 'DISABLED' | 'ARCHIVED'>;
 }
 
 export interface AlertResetParams {
   /**
-   * The Metronome ID of the alert
+   * The Metronome ID of the threshold notification
    */
   alert_id: string;