feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb/orb-71d1ace393e7a2ded73e3c2ef9778c3dfefa88b0d4975f14f6c6d4cfd044e087.yml
-openapi_spec_hash: a5c295712ca7eef32912a1ec1dfd4019
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb/orb-45297c0f1067cd444a30371110c69f876accf55f303a3dce9a4f74863b59f18f.yml
+openapi_spec_hash: cd2f638b98c6e89342397fef860166b7
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

orb-java-core/src/main/kotlin/com/withorb/api/models/BetaCreatePlanVersionParams.kt

@@ -5430,6 +5430,13 @@ private constructor(
                 fun price(matrixWithAllocation: Price.MatrixWithAllocation) =
                     price(Price.ofMatrixWithAllocation(matrixWithAllocation))
 
+                /**
+                 * Alias for calling [price] with
+                 * `Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts)`.
+                 */
+                fun price(matrixWithThresholdDiscounts: Price.MatrixWithThresholdDiscounts) =
+                    price(Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts))
+
                 /**
                  * Alias for calling [price] with
                  * `Price.ofTieredWithProration(tieredWithProration)`.

orb-java-core/src/main/kotlin/com/withorb/api/models/BetaExternalPlanIdCreatePlanVersionParams.kt

@@ -87,11 +87,18 @@ import kotlin.jvm.optionals.getOrNull
  *   determine the due date
  *
  * ## Deducting Credits
- * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb
- * matches the algorithm for automatic deductions for determining which credit blocks to decrement
- * from. In the case that the deduction leads to multiple ledger entries, the response from this
- * endpoint will be the final deduction. Orb also optionally allows specifying a description to
- * assist with auditing.
+ * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. A
+ * `decrement` entry records credits as usage and immediately recognizes revenue at the block's
+ * `per_unit_cost_basis`.
+ *
+ * For most credit removals, use `void` (no revenue impact) or `expiration_change` (revenue
+ * recognized on expiration) instead. Only use `decrement` when credits were genuinely consumed
+ * outside of normal event ingestion.
+ *
+ * Orb matches the algorithm for automatic deductions for determining which credit blocks to
+ * decrement from. In the case that the deduction leads to multiple ledger entries, the response
+ * from this endpoint will be the final deduction. Orb also optionally allows specifying a
+ * description to assist with auditing.
  *
  * The following snippet illustrates a sample request body to decrement credits.
  *

orb-java-core/src/main/kotlin/com/withorb/api/models/ChangedSubscriptionResources.kt

@@ -87,11 +87,18 @@ import kotlin.jvm.optionals.getOrNull
  *   determine the due date
  *
  * ## Deducting Credits
- * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb
- * matches the algorithm for automatic deductions for determining which credit blocks to decrement
- * from. In the case that the deduction leads to multiple ledger entries, the response from this
- * endpoint will be the final deduction. Orb also optionally allows specifying a description to
- * assist with auditing.
+ * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. A
+ * `decrement` entry records credits as usage and immediately recognizes revenue at the block's
+ * `per_unit_cost_basis`.
+ *
+ * For most credit removals, use `void` (no revenue impact) or `expiration_change` (revenue
+ * recognized on expiration) instead. Only use `decrement` when credits were genuinely consumed
+ * outside of normal event ingestion.
+ *
+ * Orb matches the algorithm for automatic deductions for determining which credit blocks to
+ * decrement from. In the case that the deduction leads to multiple ledger entries, the response
+ * from this endpoint will be the final deduction. Orb also optionally allows specifying a
+ * description to assist with auditing.
  *
  * The following snippet illustrates a sample request body to decrement credits.
  *

orb-java-core/src/main/kotlin/com/withorb/api/models/CustomerCreditLedgerCreateEntryByExternalIdParams.kt

@@ -4896,6 +4896,13 @@ private constructor(
             fun price(matrixWithAllocation: Price.MatrixWithAllocation) =
                 price(Price.ofMatrixWithAllocation(matrixWithAllocation))
 
+            /**
+             * Alias for calling [price] with
+             * `Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts)`.
+             */
+            fun price(matrixWithThresholdDiscounts: Price.MatrixWithThresholdDiscounts) =
+                price(Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts))
+
             /**
              * Alias for calling [price] with `Price.ofTieredWithProration(tieredWithProration)`.
              */

orb-java-core/src/main/kotlin/com/withorb/api/models/CustomerCreditLedgerCreateEntryParams.kt

@@ -4890,6 +4890,13 @@ private constructor(
             fun price(matrixWithAllocation: Price.MatrixWithAllocation) =
                 price(Price.ofMatrixWithAllocation(matrixWithAllocation))
 
+            /**
+             * Alias for calling [price] with
+             * `Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts)`.
+             */
+            fun price(matrixWithThresholdDiscounts: Price.MatrixWithThresholdDiscounts) =
+                price(Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts))
+
             /**
              * Alias for calling [price] with `Price.ofTieredWithProration(tieredWithProration)`.
              */

orb-java-core/src/main/kotlin/com/withorb/api/models/Invoice.kt

@@ -746,6 +746,13 @@ private constructor(
         fun price(matrixWithAllocation: Price.MatrixWithAllocation) =
             price(Price.ofMatrixWithAllocation(matrixWithAllocation))
 
+        /**
+         * Alias for calling [price] with
+         * `Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts)`.
+         */
+        fun price(matrixWithThresholdDiscounts: Price.MatrixWithThresholdDiscounts) =
+            price(Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts))
+
         /** Alias for calling [price] with `Price.ofTieredWithProration(tieredWithProration)`. */
         fun price(tieredWithProration: Price.TieredWithProration) =
             price(Price.ofTieredWithProration(tieredWithProration))

orb-java-core/src/main/kotlin/com/withorb/api/models/InvoiceFetchUpcomingResponse.kt

@@ -225,6 +225,13 @@ private constructor(
         fun price(matrixWithAllocation: Price.MatrixWithAllocation) =
             price(Price.ofMatrixWithAllocation(matrixWithAllocation))
 
+        /**
+         * Alias for calling [price] with
+         * `Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts)`.
+         */
+        fun price(matrixWithThresholdDiscounts: Price.MatrixWithThresholdDiscounts) =
+            price(Price.ofMatrixWithThresholdDiscounts(matrixWithThresholdDiscounts))
+
         /** Alias for calling [price] with `Price.ofTieredWithProration(tieredWithProration)`. */
         fun price(tieredWithProration: Price.TieredWithProration) =
             price(Price.ofTieredWithProration(tieredWithProration))