orb-billing 4.33.0 → 4.47.1

package/src/index.ts

@@ -1,12 +1,150 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import * as Errors from './error';
-import * as Uploads from './uploads';
 import { type Agent } from './_shims/index';
 import * as qs from './internal/qs';
 import * as Core from './core';
+import * as Errors from './error';
 import * as Pagination from './pagination';
+import { type PageParams, PageResponse } from './pagination';
+import * as Uploads from './uploads';
 import * as API from './resources/index';
+import {
+  Alert,
+  AlertCreateForCustomerParams,
+  AlertCreateForExternalCustomerParams,
+  AlertCreateForSubscriptionParams,
+  AlertDisableParams,
+  AlertEnableParams,
+  AlertListParams,
+  AlertUpdateParams,
+  Alerts,
+  AlertsPage,
+} from './resources/alerts';
+import {
+  CreditNote,
+  CreditNoteCreateParams,
+  CreditNoteListParams,
+  CreditNotes,
+  CreditNotesPage,
+} from './resources/credit-notes';
+import {
+  InvoiceLineItemCreateParams,
+  InvoiceLineItemCreateResponse,
+  InvoiceLineItems,
+} from './resources/invoice-line-items';
+import {
+  Invoice,
+  InvoiceCreateParams,
+  InvoiceFetchUpcomingParams,
+  InvoiceFetchUpcomingResponse,
+  InvoiceIssueParams,
+  InvoiceListParams,
+  InvoiceMarkPaidParams,
+  InvoiceUpdateParams,
+  Invoices,
+  InvoicesPage,
+} from './resources/invoices';
+import {
+  Item,
+  ItemCreateParams,
+  ItemListParams,
+  ItemUpdateParams,
+  Items,
+  ItemsPage,
+} from './resources/items';
+import {
+  BillableMetric,
+  BillableMetricsPage,
+  MetricCreateParams,
+  MetricListParams,
+  MetricUpdateParams,
+  Metrics,
+} from './resources/metrics';
+import {
+  Subscription,
+  SubscriptionCancelParams,
+  SubscriptionCancelResponse,
+  SubscriptionCreateParams,
+  SubscriptionCreateResponse,
+  SubscriptionFetchCostsParams,
+  SubscriptionFetchCostsResponse,
+  SubscriptionFetchScheduleParams,
+  SubscriptionFetchScheduleResponse,
+  SubscriptionFetchScheduleResponsesPage,
+  SubscriptionFetchUsageParams,
+  SubscriptionListParams,
+  SubscriptionPriceIntervalsParams,
+  SubscriptionPriceIntervalsResponse,
+  SubscriptionSchedulePlanChangeParams,
+  SubscriptionSchedulePlanChangeResponse,
+  SubscriptionTriggerPhaseParams,
+  SubscriptionTriggerPhaseResponse,
+  SubscriptionUnscheduleCancellationResponse,
+  SubscriptionUnscheduleFixedFeeQuantityUpdatesParams,
+  SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse,
+  SubscriptionUnschedulePendingPlanChangesResponse,
+  SubscriptionUpdateFixedFeeQuantityParams,
+  SubscriptionUpdateFixedFeeQuantityResponse,
+  SubscriptionUpdateParams,
+  SubscriptionUpdateTrialParams,
+  SubscriptionUpdateTrialResponse,
+  SubscriptionUsage,
+  Subscriptions,
+  SubscriptionsPage,
+} from './resources/subscriptions';
+import { TopLevel, TopLevelPingResponse } from './resources/top-level';
+import {
+  Coupon,
+  CouponCreateParams,
+  CouponListParams,
+  Coupons,
+  CouponsPage,
+} from './resources/coupons/coupons';
+import {
+  Customer,
+  CustomerCreateParams,
+  CustomerListParams,
+  CustomerUpdateByExternalIDParams,
+  CustomerUpdateParams,
+  Customers,
+  CustomersPage,
+} from './resources/customers/customers';
+import {
+  DimensionalPriceGroup,
+  DimensionalPriceGroupCreateParams,
+  DimensionalPriceGroupListParams,
+  DimensionalPriceGroups,
+  DimensionalPriceGroupsPage,
+} from './resources/dimensional-price-groups/dimensional-price-groups';
+import {
+  EventDeprecateResponse,
+  EventIngestParams,
+  EventIngestResponse,
+  EventSearchParams,
+  EventSearchResponse,
+  EventUpdateParams,
+  EventUpdateResponse,
+  Events,
+} from './resources/events/events';
+import {
+  Plan,
+  PlanCreateParams,
+  PlanListParams,
+  PlanUpdateParams,
+  Plans,
+  PlansPage,
+} from './resources/plans/plans';
+import {
+  EvaluatePriceGroup,
+  Price,
+  PriceCreateParams,
+  PriceEvaluateParams,
+  PriceEvaluateResponse,
+  PriceListParams,
+  PriceUpdateParams,
+  Prices,
+  PricesPage,
+} from './resources/prices/prices';
 
 export interface ClientOptions {
   /**
@@ -146,6 +284,7 @@ export class Orb extends Core.APIClient {
   subscriptions: API.Subscriptions = new API.Subscriptions(this);
   webhooks: API.Webhooks = new API.Webhooks(this);
   alerts: API.Alerts = new API.Alerts(this);
+  dimensionalPriceGroups: API.DimensionalPriceGroups = new API.DimensionalPriceGroups(this);
 
   protected override defaultQuery(): Core.DefaultQuery | undefined {
     return this._options.defaultQuery;
@@ -199,7 +338,198 @@ export class Orb extends Core.APIClient {
   static fileFromPath = Uploads.fileFromPath;
 }
 
-export const {
+Orb.TopLevel = TopLevel;
+Orb.Coupons = Coupons;
+Orb.CouponsPage = CouponsPage;
+Orb.CreditNotes = CreditNotes;
+Orb.CreditNotesPage = CreditNotesPage;
+Orb.Customers = Customers;
+Orb.CustomersPage = CustomersPage;
+Orb.Events = Events;
+Orb.InvoiceLineItems = InvoiceLineItems;
+Orb.Invoices = Invoices;
+Orb.InvoicesPage = InvoicesPage;
+Orb.Items = Items;
+Orb.ItemsPage = ItemsPage;
+Orb.Metrics = Metrics;
+Orb.BillableMetricsPage = BillableMetricsPage;
+Orb.Plans = Plans;
+Orb.PlansPage = PlansPage;
+Orb.Prices = Prices;
+Orb.PricesPage = PricesPage;
+Orb.SubscriptionsPage = SubscriptionsPage;
+Orb.SubscriptionFetchScheduleResponsesPage = SubscriptionFetchScheduleResponsesPage;
+Orb.Alerts = Alerts;
+Orb.AlertsPage = AlertsPage;
+Orb.DimensionalPriceGroupsPage = DimensionalPriceGroupsPage;
+export declare namespace Orb {
+  export type RequestOptions = Core.RequestOptions;
+
+  export import Page = Pagination.Page;
+  export { type PageParams as PageParams, type PageResponse as PageResponse };
+
+  export { TopLevel as TopLevel, type TopLevelPingResponse as TopLevelPingResponse };
+
+  export {
+    Coupons as Coupons,
+    type Coupon as Coupon,
+    CouponsPage as CouponsPage,
+    type CouponCreateParams as CouponCreateParams,
+    type CouponListParams as CouponListParams,
+  };
+
+  export {
+    CreditNotes as CreditNotes,
+    type CreditNote as CreditNote,
+    CreditNotesPage as CreditNotesPage,
+    type CreditNoteCreateParams as CreditNoteCreateParams,
+    type CreditNoteListParams as CreditNoteListParams,
+  };
+
+  export {
+    Customers as Customers,
+    type Customer as Customer,
+    CustomersPage as CustomersPage,
+    type CustomerCreateParams as CustomerCreateParams,
+    type CustomerUpdateParams as CustomerUpdateParams,
+    type CustomerListParams as CustomerListParams,
+    type CustomerUpdateByExternalIDParams as CustomerUpdateByExternalIDParams,
+  };
+
+  export {
+    Events as Events,
+    type EventUpdateResponse as EventUpdateResponse,
+    type EventDeprecateResponse as EventDeprecateResponse,
+    type EventIngestResponse as EventIngestResponse,
+    type EventSearchResponse as EventSearchResponse,
+    type EventUpdateParams as EventUpdateParams,
+    type EventIngestParams as EventIngestParams,
+    type EventSearchParams as EventSearchParams,
+  };
+
+  export {
+    InvoiceLineItems as InvoiceLineItems,
+    type InvoiceLineItemCreateResponse as InvoiceLineItemCreateResponse,
+    type InvoiceLineItemCreateParams as InvoiceLineItemCreateParams,
+  };
+
+  export {
+    Invoices as Invoices,
+    type Invoice as Invoice,
+    type InvoiceFetchUpcomingResponse as InvoiceFetchUpcomingResponse,
+    InvoicesPage as InvoicesPage,
+    type InvoiceCreateParams as InvoiceCreateParams,
+    type InvoiceUpdateParams as InvoiceUpdateParams,
+    type InvoiceListParams as InvoiceListParams,
+    type InvoiceFetchUpcomingParams as InvoiceFetchUpcomingParams,
+    type InvoiceIssueParams as InvoiceIssueParams,
+    type InvoiceMarkPaidParams as InvoiceMarkPaidParams,
+  };
+
+  export {
+    Items as Items,
+    type Item as Item,
+    ItemsPage as ItemsPage,
+    type ItemCreateParams as ItemCreateParams,
+    type ItemUpdateParams as ItemUpdateParams,
+    type ItemListParams as ItemListParams,
+  };
+
+  export {
+    Metrics as Metrics,
+    type BillableMetric as BillableMetric,
+    BillableMetricsPage as BillableMetricsPage,
+    type MetricCreateParams as MetricCreateParams,
+    type MetricUpdateParams as MetricUpdateParams,
+    type MetricListParams as MetricListParams,
+  };
+
+  export {
+    Plans as Plans,
+    type Plan as Plan,
+    PlansPage as PlansPage,
+    type PlanCreateParams as PlanCreateParams,
+    type PlanUpdateParams as PlanUpdateParams,
+    type PlanListParams as PlanListParams,
+  };
+
+  export {
+    Prices as Prices,
+    type EvaluatePriceGroup as EvaluatePriceGroup,
+    type Price as Price,
+    type PriceEvaluateResponse as PriceEvaluateResponse,
+    PricesPage as PricesPage,
+    type PriceCreateParams as PriceCreateParams,
+    type PriceUpdateParams as PriceUpdateParams,
+    type PriceListParams as PriceListParams,
+    type PriceEvaluateParams as PriceEvaluateParams,
+  };
+
+  export {
+    type Subscriptions as Subscriptions,
+    type Subscription as Subscription,
+    type SubscriptionUsage as SubscriptionUsage,
+    type SubscriptionCreateResponse as SubscriptionCreateResponse,
+    type SubscriptionCancelResponse as SubscriptionCancelResponse,
+    type SubscriptionFetchCostsResponse as SubscriptionFetchCostsResponse,
+    type SubscriptionFetchScheduleResponse as SubscriptionFetchScheduleResponse,
+    type SubscriptionPriceIntervalsResponse as SubscriptionPriceIntervalsResponse,
+    type SubscriptionSchedulePlanChangeResponse as SubscriptionSchedulePlanChangeResponse,
+    type SubscriptionTriggerPhaseResponse as SubscriptionTriggerPhaseResponse,
+    type SubscriptionUnscheduleCancellationResponse as SubscriptionUnscheduleCancellationResponse,
+    type SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse as SubscriptionUnscheduleFixedFeeQuantityUpdatesResponse,
+    type SubscriptionUnschedulePendingPlanChangesResponse as SubscriptionUnschedulePendingPlanChangesResponse,
+    type SubscriptionUpdateFixedFeeQuantityResponse as SubscriptionUpdateFixedFeeQuantityResponse,
+    type SubscriptionUpdateTrialResponse as SubscriptionUpdateTrialResponse,
+    SubscriptionsPage as SubscriptionsPage,
+    SubscriptionFetchScheduleResponsesPage as SubscriptionFetchScheduleResponsesPage,
+    type SubscriptionCreateParams as SubscriptionCreateParams,
+    type SubscriptionUpdateParams as SubscriptionUpdateParams,
+    type SubscriptionListParams as SubscriptionListParams,
+    type SubscriptionCancelParams as SubscriptionCancelParams,
+    type SubscriptionFetchCostsParams as SubscriptionFetchCostsParams,
+    type SubscriptionFetchScheduleParams as SubscriptionFetchScheduleParams,
+    type SubscriptionFetchUsageParams as SubscriptionFetchUsageParams,
+    type SubscriptionPriceIntervalsParams as SubscriptionPriceIntervalsParams,
+    type SubscriptionSchedulePlanChangeParams as SubscriptionSchedulePlanChangeParams,
+    type SubscriptionTriggerPhaseParams as SubscriptionTriggerPhaseParams,
+    type SubscriptionUnscheduleFixedFeeQuantityUpdatesParams as SubscriptionUnscheduleFixedFeeQuantityUpdatesParams,
+    type SubscriptionUpdateFixedFeeQuantityParams as SubscriptionUpdateFixedFeeQuantityParams,
+    type SubscriptionUpdateTrialParams as SubscriptionUpdateTrialParams,
+  };
+
+  export {
+    Alerts as Alerts,
+    type Alert as Alert,
+    AlertsPage as AlertsPage,
+    type AlertUpdateParams as AlertUpdateParams,
+    type AlertListParams as AlertListParams,
+    type AlertCreateForCustomerParams as AlertCreateForCustomerParams,
+    type AlertCreateForExternalCustomerParams as AlertCreateForExternalCustomerParams,
+    type AlertCreateForSubscriptionParams as AlertCreateForSubscriptionParams,
+    type AlertDisableParams as AlertDisableParams,
+    type AlertEnableParams as AlertEnableParams,
+  };
+
+  export {
+    type DimensionalPriceGroups as DimensionalPriceGroups,
+    type DimensionalPriceGroup as DimensionalPriceGroup,
+    DimensionalPriceGroupsPage as DimensionalPriceGroupsPage,
+    type DimensionalPriceGroupCreateParams as DimensionalPriceGroupCreateParams,
+    type DimensionalPriceGroupListParams as DimensionalPriceGroupListParams,
+  };
+
+  export type AmountDiscount = API.AmountDiscount;
+  export type BillingCycleRelativeDate = API.BillingCycleRelativeDate;
+  export type Discount = API.Discount;
+  export type InvoiceLevelDiscount = API.InvoiceLevelDiscount;
+  export type PaginationMetadata = API.PaginationMetadata;
+  export type PercentageDiscount = API.PercentageDiscount;
+  export type TrialDiscount = API.TrialDiscount;
+}
+
+export { toFile, fileFromPath } from './uploads';
+export {
   OrbError,
   APIError,
   APIConnectionError,
@@ -225,132 +555,6 @@ export const {
   OrbInternalServerError,
   UnprocessableEntityError,
   DuplicateResourceCreation,
-} = Errors;
-
-export import toFile = Uploads.toFile;
-export import fileFromPath = Uploads.fileFromPath;
-
-export namespace Orb {
-  export import RequestOptions = Core.RequestOptions;
-
-  export import Page = Pagination.Page;
-  export import PageParams = Pagination.PageParams;
-  export import PageResponse = Pagination.PageResponse;
-
-  export import TopLevel = API.TopLevel;
-  export import TopLevelPingResponse = API.TopLevelPingResponse;
-
-  export import Coupons = API.Coupons;
-  export import Coupon = API.Coupon;
-  export import CouponsPage = API.CouponsPage;
-  export import CouponCreateParams = API.CouponCreateParams;
-  export import CouponListParams = API.CouponListParams;
-
-  export import CreditNotes = API.CreditNotes;
-  export import CreditNote = API.CreditNote;
-  export import CreditNotesPage = API.CreditNotesPage;
-  export import CreditNoteListParams = API.CreditNoteListParams;
-
-  export import Customers = API.Customers;
-  export import Customer = API.Customer;
-  export import CustomersPage = API.CustomersPage;
-  export import CustomerCreateParams = API.CustomerCreateParams;
-  export import CustomerUpdateParams = API.CustomerUpdateParams;
-  export import CustomerListParams = API.CustomerListParams;
-  export import CustomerUpdateByExternalIDParams = API.CustomerUpdateByExternalIDParams;
-
-  export import Events = API.Events;
-  export import EventUpdateResponse = API.EventUpdateResponse;
-  export import EventDeprecateResponse = API.EventDeprecateResponse;
-  export import EventIngestResponse = API.EventIngestResponse;
-  export import EventSearchResponse = API.EventSearchResponse;
-  export import EventUpdateParams = API.EventUpdateParams;
-  export import EventIngestParams = API.EventIngestParams;
-  export import EventSearchParams = API.EventSearchParams;
-
-  export import InvoiceLineItems = API.InvoiceLineItems;
-  export import InvoiceLineItemCreateResponse = API.InvoiceLineItemCreateResponse;
-  export import InvoiceLineItemCreateParams = API.InvoiceLineItemCreateParams;
-
-  export import Invoices = API.Invoices;
-  export import Invoice = API.Invoice;
-  export import InvoiceFetchUpcomingResponse = API.InvoiceFetchUpcomingResponse;
-  export import InvoicesPage = API.InvoicesPage;
-  export import InvoiceCreateParams = API.InvoiceCreateParams;
-  export import InvoiceUpdateParams = API.InvoiceUpdateParams;
-  export import InvoiceListParams = API.InvoiceListParams;
-  export import InvoiceFetchUpcomingParams = API.InvoiceFetchUpcomingParams;
-  export import InvoiceIssueParams = API.InvoiceIssueParams;
-  export import InvoiceMarkPaidParams = API.InvoiceMarkPaidParams;
-
-  export import Items = API.Items;
-  export import Item = API.Item;
-  export import ItemsPage = API.ItemsPage;
-  export import ItemCreateParams = API.ItemCreateParams;
-  export import ItemUpdateParams = API.ItemUpdateParams;
-  export import ItemListParams = API.ItemListParams;
-
-  export import Metrics = API.Metrics;
-  export import BillableMetric = API.BillableMetric;
-  export import BillableMetricsPage = API.BillableMetricsPage;
-  export import MetricCreateParams = API.MetricCreateParams;
-  export import MetricUpdateParams = API.MetricUpdateParams;
-  export import MetricListParams = API.MetricListParams;
-
-  export import Plans = API.Plans;
-  export import Plan = API.Plan;
-  export import PlansPage = API.PlansPage;
-  export import PlanCreateParams = API.PlanCreateParams;
-  export import PlanUpdateParams = API.PlanUpdateParams;
-  export import PlanListParams = API.PlanListParams;
-
-  export import Prices = API.Prices;
-  export import EvaluatePriceGroup = API.EvaluatePriceGroup;
-  export import Price = API.Price;
-  export import PriceEvaluateResponse = API.PriceEvaluateResponse;
-  export import PricesPage = API.PricesPage;
-  export import PriceCreateParams = API.PriceCreateParams;
-  export import PriceUpdateParams = API.PriceUpdateParams;
-  export import PriceListParams = API.PriceListParams;
-  export import PriceEvaluateParams = API.PriceEvaluateParams;
-
-  export import Subscriptions = API.Subscriptions;
-  export import Subscription = API.Subscription;
-  export import SubscriptionUsage = API.SubscriptionUsage;
-  export import SubscriptionFetchCostsResponse = API.SubscriptionFetchCostsResponse;
-  export import SubscriptionFetchScheduleResponse = API.SubscriptionFetchScheduleResponse;
-  export import SubscriptionsPage = API.SubscriptionsPage;
-  export import SubscriptionFetchScheduleResponsesPage = API.SubscriptionFetchScheduleResponsesPage;
-  export import SubscriptionCreateParams = API.SubscriptionCreateParams;
-  export import SubscriptionUpdateParams = API.SubscriptionUpdateParams;
-  export import SubscriptionListParams = API.SubscriptionListParams;
-  export import SubscriptionCancelParams = API.SubscriptionCancelParams;
-  export import SubscriptionFetchCostsParams = API.SubscriptionFetchCostsParams;
-  export import SubscriptionFetchScheduleParams = API.SubscriptionFetchScheduleParams;
-  export import SubscriptionFetchUsageParams = API.SubscriptionFetchUsageParams;
-  export import SubscriptionPriceIntervalsParams = API.SubscriptionPriceIntervalsParams;
-  export import SubscriptionSchedulePlanChangeParams = API.SubscriptionSchedulePlanChangeParams;
-  export import SubscriptionTriggerPhaseParams = API.SubscriptionTriggerPhaseParams;
-  export import SubscriptionUnscheduleFixedFeeQuantityUpdatesParams = API.SubscriptionUnscheduleFixedFeeQuantityUpdatesParams;
-  export import SubscriptionUpdateFixedFeeQuantityParams = API.SubscriptionUpdateFixedFeeQuantityParams;
-  export import SubscriptionUpdateTrialParams = API.SubscriptionUpdateTrialParams;
-
-  export import Alerts = API.Alerts;
-  export import Alert = API.Alert;
-  export import AlertsPage = API.AlertsPage;
-  export import AlertUpdateParams = API.AlertUpdateParams;
-  export import AlertListParams = API.AlertListParams;
-  export import AlertCreateForCustomerParams = API.AlertCreateForCustomerParams;
-  export import AlertCreateForExternalCustomerParams = API.AlertCreateForExternalCustomerParams;
-  export import AlertCreateForSubscriptionParams = API.AlertCreateForSubscriptionParams;
-
-  export import AmountDiscount = API.AmountDiscount;
-  export import BillingCycleRelativeDate = API.BillingCycleRelativeDate;
-  export import Discount = API.Discount;
-  export import InvoiceLevelDiscount = API.InvoiceLevelDiscount;
-  export import PaginationMetadata = API.PaginationMetadata;
-  export import PercentageDiscount = API.PercentageDiscount;
-  export import TrialDiscount = API.TrialDiscount;
-}
+} from './error';
 
 export default Orb;

package/src/resources/alerts.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../resource';
 import { isRequestOptions } from '../core';
 import * as Core from '../core';
-import * as AlertsAPI from './alerts';
 import { Page, type PageParams } from '../pagination';
 
 export class Alerts extends APIResource {
@@ -110,17 +109,55 @@ export class Alerts extends APIResource {
   }
 
   /**
-   * This endpoint can be used to disable an alert.
+   * This endpoint allows you to disable an alert. To disable a plan-level alert for
+   * a specific subscription, you must include the `subscription_id`. The
+   * `subscription_id` is not required for customer or subscription level alerts.
    */
-  disable(alertConfigurationId: string, options?: Core.RequestOptions): Core.APIPromise<Alert> {
-    return this._client.post(`/alerts/${alertConfigurationId}/disable`, options);
+  disable(
+    alertConfigurationId: string,
+    params?: AlertDisableParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Alert>;
+  disable(alertConfigurationId: string, options?: Core.RequestOptions): Core.APIPromise<Alert>;
+  disable(
+    alertConfigurationId: string,
+    params: AlertDisableParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Alert> {
+    if (isRequestOptions(params)) {
+      return this.disable(alertConfigurationId, {}, params);
+    }
+    const { subscription_id } = params;
+    return this._client.post(`/alerts/${alertConfigurationId}/disable`, {
+      query: { subscription_id },
+      ...options,
+    });
   }
 
   /**
-   * This endpoint can be used to enable an alert.
+   * This endpoint allows you to enable an alert. To enable a plan-level alert for a
+   * specific subscription, you must include the `subscription_id`. The
+   * `subscription_id` is not required for customer or subscription level alerts.
    */
-  enable(alertConfigurationId: string, options?: Core.RequestOptions): Core.APIPromise<Alert> {
-    return this._client.post(`/alerts/${alertConfigurationId}/enable`, options);
+  enable(
+    alertConfigurationId: string,
+    params?: AlertEnableParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Alert>;
+  enable(alertConfigurationId: string, options?: Core.RequestOptions): Core.APIPromise<Alert>;
+  enable(
+    alertConfigurationId: string,
+    params: AlertEnableParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<Alert> {
+    if (isRequestOptions(params)) {
+      return this.enable(alertConfigurationId, {}, params);
+    }
+    const { subscription_id } = params;
+    return this._client.post(`/alerts/${alertConfigurationId}/enable`, {
+      query: { subscription_id },
+      ...options,
+    });
   }
 }
 
@@ -133,11 +170,6 @@ export class AlertsPage extends Page<Alert> {}
  *
  * Alerts created through the API can be scoped to either customers or
  * subscriptions.
- *
- * | Scope        | Monitors                       | Vaild Alert Types                                                                   |
- * | ------------ | ------------------------------ | ----------------------------------------------------------------------------------- |
- * | Customer     | A customer's credit balance    | `credit_balance_depleted`, `credit_balance_recovered`, and `credit_balance_dropped` |
- * | Subscription | A subscription's usage or cost | `usage_exceeded` and `cost_exceeded`                                                |
  */
 export interface Alert {
   /**
@@ -158,7 +190,7 @@ export interface Alert {
   /**
    * The customer the alert applies to.
    */
-  customer: Record<string, string | null> | null;
+  customer: Alert.Customer | null;
 
   /**
    * Whether the alert is enabled or disabled.
@@ -168,17 +200,17 @@ export interface Alert {
   /**
    * The metric the alert applies to.
    */
-  metric: Record<string, string | null> | null;
+  metric: Alert.Metric | null;
 
   /**
    * The plan the alert applies to.
    */
-  plan: Record<string, string | null> | null;
+  plan: Alert.Plan | null;
 
   /**
    * The subscription the alert applies to.
    */
-  subscription: Record<string, string | null> | null;
+  subscription: Alert.Subscription | null;
 
   /**
    * The thresholds that define the conditions under which the alert will be
@@ -198,6 +230,47 @@ export interface Alert {
 }
 
 export namespace Alert {
+  /**
+   * The customer the alert applies to.
+   */
+  export interface Customer {
+    id: string;
+
+    external_customer_id: string | null;
+  }
+
+  /**
+   * The metric the alert applies to.
+   */
+  export interface Metric {
+    id: string;
+  }
+
+  /**
+   * The plan the alert applies to.
+   */
+  export interface Plan {
+    id: string | null;
+
+    /**
+     * 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.
+     */
+    external_plan_id: string | null;
+
+    name: string | null;
+
+    plan_version: string;
+  }
+
+  /**
+   * The subscription the alert applies to.
+   */
+  export interface Subscription {
+    id: string;
+  }
+
   /**
    * Thresholds are used to define the conditions under which an alert will be
    * triggered.
@@ -370,12 +443,32 @@ export namespace AlertCreateForSubscriptionParams {
   }
 }
 
-export namespace Alerts {
-  export import Alert = AlertsAPI.Alert;
-  export import AlertsPage = AlertsAPI.AlertsPage;
-  export import AlertUpdateParams = AlertsAPI.AlertUpdateParams;
-  export import AlertListParams = AlertsAPI.AlertListParams;
-  export import AlertCreateForCustomerParams = AlertsAPI.AlertCreateForCustomerParams;
-  export import AlertCreateForExternalCustomerParams = AlertsAPI.AlertCreateForExternalCustomerParams;
-  export import AlertCreateForSubscriptionParams = AlertsAPI.AlertCreateForSubscriptionParams;
+export interface AlertDisableParams {
+  /**
+   * Used to update the status of a plan alert scoped to this subscription_id
+   */
+  subscription_id?: string | null;
+}
+
+export interface AlertEnableParams {
+  /**
+   * Used to update the status of a plan alert scoped to this subscription_id
+   */
+  subscription_id?: string | null;
+}
+
+Alerts.AlertsPage = AlertsPage;
+
+export declare namespace Alerts {
+  export {
+    type Alert as Alert,
+    AlertsPage as AlertsPage,
+    type AlertUpdateParams as AlertUpdateParams,
+    type AlertListParams as AlertListParams,
+    type AlertCreateForCustomerParams as AlertCreateForCustomerParams,
+    type AlertCreateForExternalCustomerParams as AlertCreateForExternalCustomerParams,
+    type AlertCreateForSubscriptionParams as AlertCreateForSubscriptionParams,
+    type AlertDisableParams as AlertDisableParams,
+    type AlertEnableParams as AlertEnableParams,
+  };
 }