feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-4ad3b44ca7f484243d8706b6aa7f4498fc5bf2b37fadf3da0a06d657e482c08f.yml
-openapi_spec_hash: 9ead1a2aae36be1086c627c3636064ea
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-e639b12e0daebce74f42d1f31f675bda4287b9c749dd7d4620a1e96a83343ec4.yml
+openapi_spec_hash: 51eb3d47b25e299de670b2d52f5e9017
 config_hash: e6db17547fe854b1c240407cf4c6dc9e

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

@@ -158,18 +158,22 @@ private constructor(
     fun adjustments(): List<Adjustment> = adjustments.getRequired("adjustments")
 
     /**
+     * Legacy field representing the parent plan if the current plan is a 'child plan', overriding
+     * prices from the parent.
+     *
      * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the server
      *   responded with an unexpected value).
      */
-    fun basePlan(): Optional<BasePlan> = basePlan.getOptional("base_plan")
+    @Deprecated("deprecated") fun basePlan(): Optional<BasePlan> = basePlan.getOptional("base_plan")
 
     /**
-     * The parent plan id if the given plan was created by overriding one or more of the parent's
-     * prices
+     * Legacy field representing the parent plan ID if the current plan is a 'child plan',
+     * overriding prices from the parent.
      *
      * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the server
      *   responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun basePlanId(): Optional<String> = basePlanId.getOptional("base_plan_id")
 
     /**
@@ -339,14 +343,20 @@ private constructor(
      *
      * Unlike [basePlan], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("base_plan") @ExcludeMissing fun _basePlan(): JsonField<BasePlan> = basePlan
+    @Deprecated("deprecated")
+    @JsonProperty("base_plan")
+    @ExcludeMissing
+    fun _basePlan(): JsonField<BasePlan> = basePlan
 
     /**
      * Returns the raw JSON value of [basePlanId].
      *
      * Unlike [basePlanId], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("base_plan_id") @ExcludeMissing fun _basePlanId(): JsonField<String> = basePlanId
+    @Deprecated("deprecated")
+    @JsonProperty("base_plan_id")
+    @ExcludeMissing
+    fun _basePlanId(): JsonField<String> = basePlanId
 
     /**
      * Returns the raw JSON value of [createdAt].
@@ -688,9 +698,15 @@ private constructor(
         fun addAdjustment(maximum: PlanPhaseMaximumAdjustment) =
             addAdjustment(Adjustment.ofMaximum(maximum))
 
+        /**
+         * Legacy field representing the parent plan if the current plan is a 'child plan',
+         * overriding prices from the parent.
+         */
+        @Deprecated("deprecated")
         fun basePlan(basePlan: BasePlan?) = basePlan(JsonField.ofNullable(basePlan))
 
         /** Alias for calling [Builder.basePlan] with `basePlan.orElse(null)`. */
+        @Deprecated("deprecated")
         fun basePlan(basePlan: Optional<BasePlan>) = basePlan(basePlan.getOrNull())
 
         /**
@@ -700,15 +716,18 @@ private constructor(
          * This method is primarily for setting the field to an undocumented or not yet supported
          * value.
          */
+        @Deprecated("deprecated")
         fun basePlan(basePlan: JsonField<BasePlan>) = apply { this.basePlan = basePlan }
 
         /**
-         * The parent plan id if the given plan was created by overriding one or more of the
-         * parent's prices
+         * Legacy field representing the parent plan ID if the current plan is a 'child plan',
+         * overriding prices from the parent.
          */
+        @Deprecated("deprecated")
         fun basePlanId(basePlanId: String?) = basePlanId(JsonField.ofNullable(basePlanId))
 
         /** Alias for calling [Builder.basePlanId] with `basePlanId.orElse(null)`. */
+        @Deprecated("deprecated")
         fun basePlanId(basePlanId: Optional<String>) = basePlanId(basePlanId.getOrNull())
 
         /**
@@ -718,6 +737,7 @@ private constructor(
          * This method is primarily for setting the field to an undocumented or not yet supported
          * value.
          */
+        @Deprecated("deprecated")
         fun basePlanId(basePlanId: JsonField<String>) = apply { this.basePlanId = basePlanId }
 
         fun createdAt(createdAt: OffsetDateTime) = createdAt(JsonField.of(createdAt))
@@ -1731,6 +1751,11 @@ private constructor(
         }
     }
 
+    /**
+     * Legacy field representing the parent plan if the current plan is a 'child plan', overriding
+     * prices from the parent.
+     */
+    @Deprecated("deprecated")
     class BasePlan
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(

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

@@ -14735,8 +14735,8 @@ private constructor(
 
         /**
          * If true, ending an in-arrears price interval mid-cycle will defer billing the final line
-         * itemuntil the next scheduled invoice. If false, it will be billed on its end date. If not
-         * provided, behaviorwill follow account default.
+         * item until the next scheduled invoice. If false, it will be billed on its end date. If
+         * not provided, behavior will follow account default.
          *
          * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -14969,8 +14969,8 @@ private constructor(
 
             /**
              * If true, ending an in-arrears price interval mid-cycle will defer billing the final
-             * line itemuntil the next scheduled invoice. If false, it will be billed on its end
-             * date. If not provided, behaviorwill follow account default.
+             * line item until the next scheduled invoice. If false, it will be billed on its end
+             * date. If not provided, behavior will follow account default.
              */
             fun canDeferBilling(canDeferBilling: Boolean?) =
                 canDeferBilling(JsonField.ofNullable(canDeferBilling))