feat(api): OpenAPI spec update via Stainless API (#371)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 93
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-90a52a59bc88bb7c8ae95cd1f8d2e0d69e48320d5481068fe1fbc54f539fd8db.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-3a9214e6a8bf5952997fd2a3b6521804ab82d2cff40ed2ecb3b3cb512fe3bf35.yml

src/orb/resources/prices/prices.py

@@ -1766,6 +1766,98 @@ def create(
         """
         ...
 
+    @overload
+    def create(
+        self,
+        *,
+        cadence: Literal["annual", "semi_annual", "monthly", "quarterly", "one_time", "custom"],
+        currency: str,
+        grouped_with_prorated_minimum_config: Dict[str, object],
+        item_id: str,
+        model_type: Literal["grouped_with_prorated_minimum"],
+        name: str,
+        billable_metric_id: Optional[str] | NotGiven = NOT_GIVEN,
+        billed_in_advance: Optional[bool] | NotGiven = NOT_GIVEN,
+        billing_cycle_configuration: Optional[
+            price_create_params.NewFloatingGroupedWithProratedMinimumPriceBillingCycleConfiguration
+        ]
+        | NotGiven = NOT_GIVEN,
+        conversion_rate: Optional[float] | NotGiven = NOT_GIVEN,
+        external_price_id: Optional[str] | NotGiven = NOT_GIVEN,
+        fixed_price_quantity: Optional[float] | NotGiven = NOT_GIVEN,
+        invoice_grouping_key: Optional[str] | NotGiven = NOT_GIVEN,
+        invoicing_cycle_configuration: Optional[
+            price_create_params.NewFloatingGroupedWithProratedMinimumPriceInvoicingCycleConfiguration
+        ]
+        | NotGiven = NOT_GIVEN,
+        metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
+    ) -> Price:
+        """This endpoint is used to create a [price](../reference/price).
+
+        A price created
+        using this endpoint is always an add-on, meaning that it’s not associated with a
+        specific plan and can instead be individually added to subscriptions, including
+        subscriptions on different plans.
+
+        An `external_price_id` can be optionally specified as an alias to allow
+        ergonomic interaction with prices in the Orb API.
+
+        See the [Price resource](../reference/price) for the specification of different
+        price model configurations possible in this endpoint.
+
+        Args:
+          cadence: The cadence to bill for this price on.
+
+          currency: An ISO 4217 currency string for which this price is billed in.
+
+          item_id: The id of the item the plan will be associated with.
+
+          name: The name of the price.
+
+          billable_metric_id: The id of the billable metric for the price. Only needed if the price is
+              usage-based.
+
+          billed_in_advance: If the Price represents a fixed cost, the price will be billed in-advance if
+              this is true, and in-arrears if this is false.
+
+          billing_cycle_configuration: For custom cadence: specifies the duration of the billing period in days or
+              months.
+
+          conversion_rate: The per unit conversion rate of the price currency to the invoicing currency.
+
+          external_price_id: An alias for the price.
+
+          fixed_price_quantity: If the Price represents a fixed cost, this represents the quantity of units
+              applied.
+
+          invoice_grouping_key: The property used to group this price on an invoice
+
+          invoicing_cycle_configuration: Within each billing cycle, specifies the cadence at which invoices are produced.
+              If unspecified, a single invoice is produced per billing cycle.
+
+          metadata: User-specified key/value pairs for the resource. Individual keys can be removed
+              by setting the value to `null`, and the entire metadata mapping can be cleared
+              by setting `metadata` to `null`.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        ...
+
     @overload
     def create(
         self,
@@ -1878,6 +1970,7 @@ def create(
         ["cadence", "currency", "item_id", "model_type", "name", "tiered_with_proration_config"],
         ["cadence", "currency", "item_id", "model_type", "name", "unit_with_proration_config"],
         ["cadence", "currency", "grouped_allocation_config", "item_id", "model_type", "name"],
+        ["cadence", "currency", "grouped_with_prorated_minimum_config", "item_id", "model_type", "name"],
         ["bulk_with_proration_config", "cadence", "currency", "item_id", "model_type", "name"],
     )
     def create(
@@ -1905,6 +1998,7 @@ def create(
         | Literal["tiered_with_proration"]
         | Literal["unit_with_proration"]
         | Literal["grouped_allocation"]
+        | Literal["grouped_with_prorated_minimum"]
         | Literal["bulk_with_proration"],
         name: str,
         unit_config: price_create_params.NewFloatingUnitPriceUnitConfig | NotGiven = NOT_GIVEN,
@@ -1938,6 +2032,7 @@ def create(
         tiered_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         unit_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         grouped_allocation_config: Dict[str, object] | NotGiven = NOT_GIVEN,
+        grouped_with_prorated_minimum_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         bulk_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1986,6 +2081,7 @@ def create(
                         "tiered_with_proration_config": tiered_with_proration_config,
                         "unit_with_proration_config": unit_with_proration_config,
                         "grouped_allocation_config": grouped_allocation_config,
+                        "grouped_with_prorated_minimum_config": grouped_with_prorated_minimum_config,
                         "bulk_with_proration_config": bulk_with_proration_config,
                     },
                     price_create_params.PriceCreateParams,
@@ -3963,6 +4059,98 @@ async def create(
         """
         ...
 
+    @overload
+    async def create(
+        self,
+        *,
+        cadence: Literal["annual", "semi_annual", "monthly", "quarterly", "one_time", "custom"],
+        currency: str,
+        grouped_with_prorated_minimum_config: Dict[str, object],
+        item_id: str,
+        model_type: Literal["grouped_with_prorated_minimum"],
+        name: str,
+        billable_metric_id: Optional[str] | NotGiven = NOT_GIVEN,
+        billed_in_advance: Optional[bool] | NotGiven = NOT_GIVEN,
+        billing_cycle_configuration: Optional[
+            price_create_params.NewFloatingGroupedWithProratedMinimumPriceBillingCycleConfiguration
+        ]
+        | NotGiven = NOT_GIVEN,
+        conversion_rate: Optional[float] | NotGiven = NOT_GIVEN,
+        external_price_id: Optional[str] | NotGiven = NOT_GIVEN,
+        fixed_price_quantity: Optional[float] | NotGiven = NOT_GIVEN,
+        invoice_grouping_key: Optional[str] | NotGiven = NOT_GIVEN,
+        invoicing_cycle_configuration: Optional[
+            price_create_params.NewFloatingGroupedWithProratedMinimumPriceInvoicingCycleConfiguration
+        ]
+        | NotGiven = NOT_GIVEN,
+        metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        idempotency_key: str | None = None,
+    ) -> Price:
+        """This endpoint is used to create a [price](../reference/price).
+
+        A price created
+        using this endpoint is always an add-on, meaning that it’s not associated with a
+        specific plan and can instead be individually added to subscriptions, including
+        subscriptions on different plans.
+
+        An `external_price_id` can be optionally specified as an alias to allow
+        ergonomic interaction with prices in the Orb API.
+
+        See the [Price resource](../reference/price) for the specification of different
+        price model configurations possible in this endpoint.
+
+        Args:
+          cadence: The cadence to bill for this price on.
+
+          currency: An ISO 4217 currency string for which this price is billed in.
+
+          item_id: The id of the item the plan will be associated with.
+
+          name: The name of the price.
+
+          billable_metric_id: The id of the billable metric for the price. Only needed if the price is
+              usage-based.
+
+          billed_in_advance: If the Price represents a fixed cost, the price will be billed in-advance if
+              this is true, and in-arrears if this is false.
+
+          billing_cycle_configuration: For custom cadence: specifies the duration of the billing period in days or
+              months.
+
+          conversion_rate: The per unit conversion rate of the price currency to the invoicing currency.
+
+          external_price_id: An alias for the price.
+
+          fixed_price_quantity: If the Price represents a fixed cost, this represents the quantity of units
+              applied.
+
+          invoice_grouping_key: The property used to group this price on an invoice
+
+          invoicing_cycle_configuration: Within each billing cycle, specifies the cadence at which invoices are produced.
+              If unspecified, a single invoice is produced per billing cycle.
+
+          metadata: User-specified key/value pairs for the resource. Individual keys can be removed
+              by setting the value to `null`, and the entire metadata mapping can be cleared
+              by setting `metadata` to `null`.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        ...
+
     @overload
     async def create(
         self,
@@ -4075,6 +4263,7 @@ async def create(
         ["cadence", "currency", "item_id", "model_type", "name", "tiered_with_proration_config"],
         ["cadence", "currency", "item_id", "model_type", "name", "unit_with_proration_config"],
         ["cadence", "currency", "grouped_allocation_config", "item_id", "model_type", "name"],
+        ["cadence", "currency", "grouped_with_prorated_minimum_config", "item_id", "model_type", "name"],
         ["bulk_with_proration_config", "cadence", "currency", "item_id", "model_type", "name"],
     )
     async def create(
@@ -4102,6 +4291,7 @@ async def create(
         | Literal["tiered_with_proration"]
         | Literal["unit_with_proration"]
         | Literal["grouped_allocation"]
+        | Literal["grouped_with_prorated_minimum"]
         | Literal["bulk_with_proration"],
         name: str,
         unit_config: price_create_params.NewFloatingUnitPriceUnitConfig | NotGiven = NOT_GIVEN,
@@ -4135,6 +4325,7 @@ async def create(
         tiered_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         unit_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         grouped_allocation_config: Dict[str, object] | NotGiven = NOT_GIVEN,
+        grouped_with_prorated_minimum_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         bulk_with_proration_config: Dict[str, object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -4183,6 +4374,7 @@ async def create(
                         "tiered_with_proration_config": tiered_with_proration_config,
                         "unit_with_proration_config": unit_with_proration_config,
                         "grouped_allocation_config": grouped_allocation_config,
+                        "grouped_with_prorated_minimum_config": grouped_with_prorated_minimum_config,
                         "bulk_with_proration_config": bulk_with_proration_config,
                     },
                     price_create_params.PriceCreateParams,

src/orb/types/plan_create_params.py

@@ -69,6 +69,9 @@
     "PriceNewPlanGroupedAllocationPrice",
     "PriceNewPlanGroupedAllocationPriceBillingCycleConfiguration",
     "PriceNewPlanGroupedAllocationPriceInvoicingCycleConfiguration",
+    "PriceNewPlanGroupedWithProratedMinimumPrice",
+    "PriceNewPlanGroupedWithProratedMinimumPriceBillingCycleConfiguration",
+    "PriceNewPlanGroupedWithProratedMinimumPriceInvoicingCycleConfiguration",
     "PriceNewPlanBulkWithProrationPrice",
     "PriceNewPlanBulkWithProrationPriceBillingCycleConfiguration",
     "PriceNewPlanBulkWithProrationPriceInvoicingCycleConfiguration",
@@ -1564,6 +1567,89 @@ class PriceNewPlanGroupedAllocationPrice(TypedDict, total=False):
     """
 
 
+class PriceNewPlanGroupedWithProratedMinimumPriceBillingCycleConfiguration(TypedDict, total=False):
+    duration: Required[int]
+    """The duration of the billing period."""
+
+    duration_unit: Required[Literal["day", "month"]]
+    """The unit of billing period duration."""
+
+
+class PriceNewPlanGroupedWithProratedMinimumPriceInvoicingCycleConfiguration(TypedDict, total=False):
+    duration: Required[int]
+    """The duration of the billing period."""
+
+    duration_unit: Required[Literal["day", "month"]]
+    """The unit of billing period duration."""
+
+
+class PriceNewPlanGroupedWithProratedMinimumPrice(TypedDict, total=False):
+    cadence: Required[Literal["annual", "semi_annual", "monthly", "quarterly", "one_time", "custom"]]
+    """The cadence to bill for this price on."""
+
+    grouped_with_prorated_minimum_config: Required[Dict[str, object]]
+
+    item_id: Required[str]
+    """The id of the item the plan will be associated with."""
+
+    model_type: Required[Literal["grouped_with_prorated_minimum"]]
+
+    name: Required[str]
+    """The name of the price."""
+
+    billable_metric_id: Optional[str]
+    """The id of the billable metric for the price.
+
+    Only needed if the price is usage-based.
+    """
+
+    billed_in_advance: Optional[bool]
+    """
+    If the Price represents a fixed cost, the price will be billed in-advance if
+    this is true, and in-arrears if this is false.
+    """
+
+    billing_cycle_configuration: Optional[PriceNewPlanGroupedWithProratedMinimumPriceBillingCycleConfiguration]
+    """
+    For custom cadence: specifies the duration of the billing period in days or
+    months.
+    """
+
+    conversion_rate: Optional[float]
+    """The per unit conversion rate of the price currency to the invoicing currency."""
+
+    currency: Optional[str]
+    """
+    An ISO 4217 currency string, or custom pricing unit identifier, in which this
+    price is billed.
+    """
+
+    external_price_id: Optional[str]
+    """An alias for the price."""
+
+    fixed_price_quantity: Optional[float]
+    """
+    If the Price represents a fixed cost, this represents the quantity of units
+    applied.
+    """
+
+    invoice_grouping_key: Optional[str]
+    """The property used to group this price on an invoice"""
+
+    invoicing_cycle_configuration: Optional[PriceNewPlanGroupedWithProratedMinimumPriceInvoicingCycleConfiguration]
+    """Within each billing cycle, specifies the cadence at which invoices are produced.
+
+    If unspecified, a single invoice is produced per billing cycle.
+    """
+
+    metadata: Optional[Dict[str, Optional[str]]]
+    """User-specified key/value pairs for the resource.
+
+    Individual keys can be removed by setting the value to `null`, and the entire
+    metadata mapping can be cleared by setting `metadata` to `null`.
+    """
+
+
 class PriceNewPlanBulkWithProrationPriceBillingCycleConfiguration(TypedDict, total=False):
     duration: Required[int]
     """The duration of the billing period."""
@@ -1664,5 +1750,6 @@ class PriceNewPlanBulkWithProrationPrice(TypedDict, total=False):
     PriceNewPlanTierWithProrationPrice,
     PriceNewPlanUnitWithProrationPrice,
     PriceNewPlanGroupedAllocationPrice,
+    PriceNewPlanGroupedWithProratedMinimumPrice,
     PriceNewPlanBulkWithProrationPrice,
 ]