@metronome/sdk 0.3.0 → 2.0.0

package/resources/v1/customers/alerts.d.mts

@@ -0,0 +1,309 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as Shared from "../../shared.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { CursorPageWithoutLimit, type CursorPageWithoutLimitParams, PagePromise } from "../../../core/pagination.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Alerts extends APIResource {
+    /**
+     * 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 threshold notification
+     *   (`in_alarm` status)
+     * - 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:
+     *
+     * A CustomerAlert object containing:
+     *
+     * - `customer_status`: The current evaluation state
+     *
+     * - `ok` - Customer is within acceptable thresholds
+     * - `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
+     *   - 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 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
+     * ```ts
+     * const alert = await client.v1.customers.alerts.retrieve({
+     *   alert_id: '8deed800-1b7a-495d-a207-6c52bac54dc9',
+     *   customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1',
+     * });
+     * ```
+     */
+    retrieve(body: AlertRetrieveParams, options?: RequestOptions): APIPromise<AlertRetrieveResponse>;
+    /**
+     * 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 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 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 threshold notifications unless
+     *   `alert_statuses` filter is specified
+     * - Pagination: Use the `next_page` cursor to retrieve all results for customers
+     *   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
+     * // Automatically fetches more pages as needed.
+     * for await (const customerAlert of client.v1.customers.alerts.list(
+     *   { customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(params: AlertListParams, options?: RequestOptions): PagePromise<CustomerAlertsCursorPageWithoutLimit, CustomerAlert>;
+    /**
+     * 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 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 threshold notification has been reset and
+     *   re-evaluation initiated
+     * - No response body is returned - the operation completes asynchronously
+     *
+     * ### Usage guidelines:
+     *
+     * - Immediate effect: Triggers re-evaluation instantly, which may result in new
+     *   webhook notifications if thresholds are breached
+     * - State clearing: Removes any cached evaluation state, ensuring a fresh
+     *   assessment
+     * - Use sparingly: Intended for exceptional cases, not routine operations
+     * - Asynchronous processing: The reset completes immediately, but re-evaluation
+     *   happens in the background
+     *
+     * @example
+     * ```ts
+     * await client.v1.customers.alerts.reset({
+     *   alert_id: '5e8691bf-b22a-4672-922d-f80eee940f01',
+     *   customer_id: '4c83caf3-8af4-44e2-9aeb-e290531726d9',
+     * });
+     * ```
+     */
+    reset(body: AlertResetParams, options?: RequestOptions): APIPromise<void>;
+}
+export type CustomerAlertsCursorPageWithoutLimit = CursorPageWithoutLimit<CustomerAlert>;
+export interface CustomerAlert {
+    alert: CustomerAlert.Alert;
+    /**
+     * 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 threshold notification was triggered.
+     */
+    triggered_by?: string | null;
+}
+export declare namespace CustomerAlert {
+    interface Alert {
+        /**
+         * the Metronome ID of the threshold notification
+         */
+        id: string;
+        /**
+         * Name of the threshold notification
+         */
+        name: string;
+        /**
+         * Status of the threshold notification
+         */
+        status: 'enabled' | 'archived' | 'disabled';
+        /**
+         * Threshold value of the notification policy
+         */
+        threshold: number;
+        /**
+         * Type of the threshold notification
+         */
+        type: 'low_credit_balance_reached' | 'spend_threshold_reached' | 'monthly_invoice_total_spend_threshold_reached' | 'low_remaining_days_in_plan_reached' | 'low_remaining_credit_percentage_reached' | 'usage_threshold_reached' | 'low_remaining_days_for_commit_segment_reached' | 'low_remaining_commit_balance_reached' | 'low_remaining_commit_percentage_reached' | 'low_remaining_days_for_contract_credit_segment_reached' | 'low_remaining_contract_credit_balance_reached' | 'low_remaining_contract_credit_percentage_reached' | 'low_remaining_contract_credit_and_commit_balance_reached' | 'invoice_total_reached';
+        /**
+         * 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
+         * 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 notification types that support advanced
+         * filtering
+         */
+        custom_field_filters?: Array<Alert.CustomFieldFilter>;
+        /**
+         * 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` notifications. Scope notification to
+         * a specific group key on individual line items.
+         */
+        group_values?: Array<Alert.GroupValue>;
+        /**
+         * Only supported for invoice_total_reached threshold notifications. A list of
+         * invoice types to evaluate.
+         */
+        invoice_types_filter?: Array<string>;
+        /**
+         * Prevents the creation of duplicates. If a request to create a record is made
+         * with a previously used uniqueness key, a new record will not be created and the
+         * request will fail with a 409 error.
+         */
+        uniqueness_key?: string;
+    }
+    namespace Alert {
+        interface CustomFieldFilter {
+            entity: 'Contract' | 'Commit' | 'ContractCredit';
+            key: string;
+            value: string;
+        }
+        /**
+         * Scopes threshold notification evaluation to a specific presentation group key on
+         * individual line items. Only present for spend notifications.
+         */
+        interface GroupKeyFilter {
+            key: string;
+            value: string;
+        }
+        interface GroupValue {
+            key: string;
+            value?: string;
+        }
+    }
+}
+export interface AlertRetrieveResponse {
+    data: CustomerAlert;
+}
+export interface AlertRetrieveParams {
+    /**
+     * The Metronome ID of the threshold notification
+     */
+    alert_id: string;
+    /**
+     * The Metronome ID of the customer
+     */
+    customer_id: string;
+    /**
+     * Only present for `spend_threshold_reached` notifications. Retrieve the
+     * notification for a specific group key-value pair.
+     */
+    group_values?: Array<AlertRetrieveParams.GroupValue>;
+    /**
+     * 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 declare namespace AlertRetrieveParams {
+    /**
+     * Scopes threshold notification evaluation to a specific presentation group key on
+     * individual line items. Only present for spend notifications.
+     */
+    interface GroupValue {
+        key: string;
+        value: string;
+    }
+}
+export interface AlertListParams extends CursorPageWithoutLimitParams {
+    /**
+     * Body param: The Metronome ID of the customer
+     */
+    customer_id: string;
+    /**
+     * 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 threshold notification
+     */
+    alert_id: string;
+    /**
+     * The Metronome ID of the customer
+     */
+    customer_id: string;
+}
+export declare namespace Alerts {
+    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type CustomerAlertsCursorPageWithoutLimit as CustomerAlertsCursorPageWithoutLimit, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
+}
+//# sourceMappingURL=alerts.d.mts.map

package/resources/v1/customers/alerts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/customers/alerts.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,65 @@
-import { APIResource } from "../../../resource.js";
-import * as Core from "../../../core.js";
+import { APIResource } from "../../../core/resource.js";
 import * as Shared from "../../shared.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { CursorPageWithoutLimit, type CursorPageWithoutLimitParams, PagePromise } from "../../../core/pagination.js";
+import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Alerts extends APIResource {
     /**
-     * Get the customer alert status and alert information for the specified customer
-     * and alert
+     * 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 threshold notification
+     *   (`in_alarm` status)
+     * - 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:
+     *
+     * A CustomerAlert object containing:
+     *
+     * - `customer_status`: The current evaluation state
+     *
+     * - `ok` - Customer is within acceptable thresholds
+     * - `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
+     *   - 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 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
      * ```ts
@@ -14,20 +69,81 @@ export declare class Alerts extends APIResource {
      * });
      * ```
      */
-    retrieve(body: AlertRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<AlertRetrieveResponse>;
+    retrieve(body: AlertRetrieveParams, options?: RequestOptions): APIPromise<AlertRetrieveResponse>;
     /**
-     * Fetch all customer alert statuses and alert information for a customer
+     * 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 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 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 threshold notifications unless
+     *   `alert_statuses` filter is specified
+     * - Pagination: Use the `next_page` cursor to retrieve all results for customers
+     *   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
-     * const alerts = await client.v1.customers.alerts.list({
-     *   customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1',
-     * });
+     * // Automatically fetches more pages as needed.
+     * for await (const customerAlert of client.v1.customers.alerts.list(
+     *   { customer_id: '9b85c1c1-5238-4f2a-a409-61412905e1e1' },
+     * )) {
+     *   // ...
+     * }
      * ```
      */
-    list(params: AlertListParams, options?: Core.RequestOptions): Core.APIPromise<AlertListResponse>;
+    list(params: AlertListParams, options?: RequestOptions): PagePromise<CustomerAlertsCursorPageWithoutLimit, CustomerAlert>;
     /**
-     * Reset state for an alert by customer id and force re-evaluation
+     * 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 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 threshold notification has been reset and
+     *   re-evaluation initiated
+     * - No response body is returned - the operation completes asynchronously
+     *
+     * ### Usage guidelines:
+     *
+     * - Immediate effect: Triggers re-evaluation instantly, which may result in new
+     *   webhook notifications if thresholds are breached
+     * - State clearing: Removes any cached evaluation state, ensuring a fresh
+     *   assessment
+     * - Use sparingly: Intended for exceptional cases, not routine operations
+     * - Asynchronous processing: The reset completes immediately, but re-evaluation
+     *   happens in the background
      *
      * @example
      * ```ts
@@ -37,70 +153,73 @@ export declare class Alerts extends APIResource {
      * });
      * ```
      */
-    reset(body: AlertResetParams, options?: Core.RequestOptions): Core.APIPromise<void>;
+    reset(body: AlertResetParams, options?: RequestOptions): APIPromise<void>;
 }
+export type CustomerAlertsCursorPageWithoutLimit = CursorPageWithoutLimit<CustomerAlert>;
 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;
 }
 export declare namespace CustomerAlert {
     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' | 'spend_threshold_reached' | 'monthly_invoice_total_spend_threshold_reached' | 'low_remaining_days_in_plan_reached' | 'low_remaining_credit_percentage_reached' | 'usage_threshold_reached' | 'low_remaining_days_for_commit_segment_reached' | 'low_remaining_commit_balance_reached' | 'low_remaining_commit_percentage_reached' | 'low_remaining_days_for_contract_credit_segment_reached' | 'low_remaining_contract_credit_balance_reached' | 'low_remaining_contract_credit_percentage_reached' | 'low_remaining_contract_credit_and_commit_balance_reached' | '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>;
         /**
@@ -117,8 +236,8 @@ export declare namespace CustomerAlert {
             value: string;
         }
         /**
-         * 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.
          */
         interface GroupKeyFilter {
             key: string;
@@ -126,20 +245,16 @@ export declare namespace CustomerAlert {
         }
         interface GroupValue {
             key: string;
-            value: string;
+            value?: string;
         }
     }
 }
 export interface AlertRetrieveResponse {
     data: CustomerAlert;
 }
-export interface AlertListResponse {
-    data: Array<CustomerAlert>;
-    next_page: string | null;
-}
 export interface AlertRetrieveParams {
     /**
-     * The Metronome ID of the alert
+     * The Metronome ID of the threshold notification
      */
     alert_id: string;
     /**
@@ -147,29 +262,40 @@ export interface AlertRetrieveParams {
      */
     customer_id: string;
     /**
-     * When parallel alerts are enabled during migration, this flag denotes whether to
-     * fetch alerts for plans or contracts.
+     * Only present for `spend_threshold_reached` notifications. Retrieve the
+     * notification for a specific group key-value pair.
+     */
+    group_values?: Array<AlertRetrieveParams.GroupValue>;
+    /**
+     * 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 interface AlertListParams {
+export declare namespace AlertRetrieveParams {
     /**
-     * Body param: The Metronome ID of the customer
+     * Scopes threshold notification evaluation to a specific presentation group key on
+     * individual line items. Only present for spend notifications.
      */
-    customer_id: string;
+    interface GroupValue {
+        key: string;
+        value: string;
+    }
+}
+export interface AlertListParams extends CursorPageWithoutLimitParams {
     /**
-     * Query param: Cursor that indicates where the next page of results should start.
+     * Body param: The Metronome ID of the customer
      */
-    next_page?: string;
+    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;
     /**
@@ -178,6 +304,6 @@ export interface AlertResetParams {
     customer_id: string;
 }
 export declare namespace Alerts {
-    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type AlertListResponse as AlertListResponse, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
+    export { type CustomerAlert as CustomerAlert, type AlertRetrieveResponse as AlertRetrieveResponse, type CustomerAlertsCursorPageWithoutLimit as CustomerAlertsCursorPageWithoutLimit, type AlertRetrieveParams as AlertRetrieveParams, type AlertListParams as AlertListParams, type AlertResetParams as AlertResetParams, };
 }
 //# sourceMappingURL=alerts.d.ts.map