chore(docs): updates price intervals docs (#302)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 90
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-2ec02cbf3446827f8bbc949216aec29ff745d79c39f1aa1b7ce2289eab0f338f.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb-75733a914692b0abe72ba99d622fc55b20da1c7fa7f73e2bfee30dfe32b66a51.yml

src/orb/resources/subscriptions.py

@@ -1286,6 +1286,21 @@ def price_intervals(
         interval. This will only apply to this price interval, not any other price
         intervals on the subscription.
 
+        ## Adjustment intervals
+
+        An adjustment interval represents the time period that a particular adjustment
+        (a discount, minimum, or maximum) applies to the prices on a subscription.
+        Adjustment intervals can be added to a subscription by specifying them in the
+        `add_adjustments` array, or modified via the `edit_adjustments` array. When
+        creating an adjustment interval, you'll need to provide the definition of the
+        new adjustment (the type of adjustment, and which prices it applies to), as well
+        as the start and end dates for the adjustment interval. The start and end dates
+        of an existing adjustment interval can be edited via the `edit_adjustments`
+        field (just like price intervals). (To "change" the amount of a discount,
+        minimum, or maximum, then, you'll need to end the existing interval, and create
+        a new adjustment interval with the new amount and a start date that matches the
+        end date of the previous interval.)
+
         ## Editing price intervals
 
         Price intervals can be adjusted by specifying edits to make in the `edit` array.
@@ -3006,6 +3021,21 @@ async def price_intervals(
         interval. This will only apply to this price interval, not any other price
         intervals on the subscription.
 
+        ## Adjustment intervals
+
+        An adjustment interval represents the time period that a particular adjustment
+        (a discount, minimum, or maximum) applies to the prices on a subscription.
+        Adjustment intervals can be added to a subscription by specifying them in the
+        `add_adjustments` array, or modified via the `edit_adjustments` array. When
+        creating an adjustment interval, you'll need to provide the definition of the
+        new adjustment (the type of adjustment, and which prices it applies to), as well
+        as the start and end dates for the adjustment interval. The start and end dates
+        of an existing adjustment interval can be edited via the `edit_adjustments`
+        field (just like price intervals). (To "change" the amount of a discount,
+        minimum, or maximum, then, you'll need to end the existing interval, and create
+        a new adjustment interval with the new amount and a start date that matches the
+        end date of the previous interval.)
+
         ## Editing price intervals
 
         Price intervals can be adjusted by specifying edits to make in the `edit` array.