release: 1.69.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.68.0"
+  ".": "1.69.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-1ca41c4b1d872cf2a198c8cf5edeeeddac012259a7cf211b102bf137c05b8240.yml
-openapi_spec_hash: 955066d4865fc42440cd81e40f5f79cd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-2b77f13a159cf689a3bba6ac5ff03b6c0df62b772e2da04aff52be86710ca4d4.yml
+openapi_spec_hash: 28a3f685403d98ddd68b427d92ed28fb
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.69.0 (2026-04-11)
+
+Full Changelog: [v1.68.0...v1.69.0](https://github.com/orbcorp/orb-go/compare/v1.68.0...v1.69.0)
+
+### Features
+
+* **api:** api update ([16d7ed9](https://github.com/orbcorp/orb-go/commit/16d7ed97c254d0b845083a04362fe30b8daf59e8))
+
+
+### Documentation
+
+* improve examples ([0be0b27](https://github.com/orbcorp/orb-go/commit/0be0b27fded5be04aea7dad0bc196f298b72f2f0))
+
 ## 1.68.0 (2026-04-03)
 
 Full Changelog: [v1.67.0...v1.68.0](https://github.com/orbcorp/orb-go/compare/v1.67.0...v1.68.0)

README.md

@@ -22,7 +22,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/orbcorp/orb-go@v1.68.0'
+go get -u 'github.com/orbcorp/orb-go@v1.69.0'
 ```
 
 <!-- x-release-please-end -->

creditblock.go

@@ -79,14 +79,17 @@ func (r *CreditBlockService) Delete(ctx context.Context, blockID string, opts ..
 
 // This endpoint returns the credit block and its associated purchasing invoices.
 //
-// If a credit block was purchased (as opposed to being manually added or allocated
-// from a subscription), this endpoint returns the invoices that were created to
-// charge the customer for the credit block. For credit blocks with payment
-// schedules spanning multiple periods (e.g., monthly payments over 12 months),
-// multiple invoices will be returned.
+// If a credit block was purchased (as opposed to being manually added), this
+// endpoint returns the invoices that were created to charge the customer for the
+// credit block. For credit blocks with payment schedules spanning multiple periods
+// (e.g., monthly payments over 12 months), multiple invoices will be returned.
 //
-// If the credit block was not purchased (e.g., manual increment, allocation), an
-// empty invoices list is returned.
+// For credit blocks created by subscription allocation prices, this endpoint
+// returns the subscription invoice containing the allocation line item that
+// created the block.
+//
+// If the credit block was not purchased (e.g., manual increment), an empty
+// invoices list is returned.
 //
 // **Note: This endpoint is currently experimental and its interface may change in
 // future releases. Please contact support before building production integrations

internal/version.go

@@ -2,4 +2,4 @@
 
 package internal
 
-const PackageVersion = "1.68.0" // x-release-please-version
+const PackageVersion = "1.69.0" // x-release-please-version

subscription_test.go

@@ -509,7 +509,7 @@ func TestSubscriptionPriceIntervalsWithOptionalParams(t *testing.T) {
 		"subscription_id",
 		orb.SubscriptionPriceIntervalsParams{
 			Add: orb.F([]orb.SubscriptionPriceIntervalsParamsAdd{{
-				StartDate: orb.F[orb.SubscriptionPriceIntervalsParamsAddStartDateUnion](shared.UnionTime(time.Now())),
+				StartDate: orb.F[orb.SubscriptionPriceIntervalsParamsAddStartDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 				AllocationPrice: orb.F(shared.NewAllocationPriceParam{
 					Amount:   orb.F("10.00"),
 					Cadence:  orb.F(shared.NewAllocationPriceCadenceMonthly),
@@ -533,7 +533,7 @@ func TestSubscriptionPriceIntervalsWithOptionalParams(t *testing.T) {
 					AmountDiscount: orb.F(0.000000),
 					DiscountType:   orb.F(orb.SubscriptionPriceIntervalsParamsAddDiscountsAmountDiscountCreationParamsDiscountTypeAmount),
 				}}),
-				EndDate:         orb.F[orb.SubscriptionPriceIntervalsParamsAddEndDateUnion](shared.UnionTime(time.Now())),
+				EndDate:         orb.F[orb.SubscriptionPriceIntervalsParamsAddEndDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 				ExternalPriceID: orb.F("external_price_id"),
 				Filter:          orb.F("my_property > 100 AND my_other_property = 'bar'"),
 				FixedFeeQuantityTransitions: orb.F([]orb.SubscriptionPriceIntervalsParamsAddFixedFeeQuantityTransition{{
@@ -589,7 +589,7 @@ func TestSubscriptionPriceIntervalsWithOptionalParams(t *testing.T) {
 				UsageCustomerIDs: orb.F([]string{"string"}),
 			}}),
 			AddAdjustments: orb.F([]orb.SubscriptionPriceIntervalsParamsAddAdjustment{{
-				StartDate: orb.F[orb.SubscriptionPriceIntervalsParamsAddAdjustmentsStartDateUnion](shared.UnionTime(time.Now())),
+				StartDate: orb.F[orb.SubscriptionPriceIntervalsParamsAddAdjustmentsStartDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 				Adjustment: orb.F[orb.SubscriptionPriceIntervalsParamsAddAdjustmentsAdjustmentUnion](shared.NewPercentageDiscountParam{
 					AdjustmentType:     orb.F(shared.NewPercentageDiscountAdjustmentTypePercentageDiscount),
 					PercentageDiscount: orb.F(0.000000),
@@ -606,15 +606,15 @@ func TestSubscriptionPriceIntervalsWithOptionalParams(t *testing.T) {
 					PriceType:      orb.F(shared.NewPercentageDiscountPriceTypeUsage),
 				}),
 				AdjustmentID: orb.F("h74gfhdjvn7ujokd"),
-				EndDate:      orb.F[orb.SubscriptionPriceIntervalsParamsAddAdjustmentsEndDateUnion](shared.UnionTime(time.Now())),
+				EndDate:      orb.F[orb.SubscriptionPriceIntervalsParamsAddAdjustmentsEndDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 			}}),
 			AllowInvoiceCreditOrVoid: orb.F(true),
 			CanDeferBilling:          orb.F(true),
 			Edit: orb.F([]orb.SubscriptionPriceIntervalsParamsEdit{{
 				PriceIntervalID: orb.F("sdfs6wdjvn7ujokd"),
 				BillingCycleDay: orb.F(int64(0)),
 				CanDeferBilling: orb.F(true),
-				EndDate:         orb.F[orb.SubscriptionPriceIntervalsParamsEditEndDateUnion](shared.UnionTime(time.Now())),
+				EndDate:         orb.F[orb.SubscriptionPriceIntervalsParamsEditEndDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 				Filter:          orb.F("my_property > 100 AND my_other_property = 'bar'"),
 				FixedFeeQuantityTransitions: orb.F([]orb.SubscriptionPriceIntervalsParamsEditFixedFeeQuantityTransition{{
 					EffectiveDate: orb.F(time.Now()),
@@ -623,13 +623,13 @@ func TestSubscriptionPriceIntervalsWithOptionalParams(t *testing.T) {
 				MetricParameterOverrides: orb.F(map[string]interface{}{
 					"foo": "bar",
 				}),
-				StartDate:        orb.F[orb.SubscriptionPriceIntervalsParamsEditStartDateUnion](shared.UnionTime(time.Now())),
+				StartDate:        orb.F[orb.SubscriptionPriceIntervalsParamsEditStartDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 				UsageCustomerIDs: orb.F([]string{"string"}),
 			}}),
 			EditAdjustments: orb.F([]orb.SubscriptionPriceIntervalsParamsEditAdjustment{{
 				AdjustmentIntervalID: orb.F("sdfs6wdjvn7ujokd"),
-				EndDate:              orb.F[orb.SubscriptionPriceIntervalsParamsEditAdjustmentsEndDateUnion](shared.UnionTime(time.Now())),
-				StartDate:            orb.F[orb.SubscriptionPriceIntervalsParamsEditAdjustmentsStartDateUnion](shared.UnionTime(time.Now())),
+				EndDate:              orb.F[orb.SubscriptionPriceIntervalsParamsEditAdjustmentsEndDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
+				StartDate:            orb.F[orb.SubscriptionPriceIntervalsParamsEditAdjustmentsStartDateUnion](shared.BillingCycleRelativeDate(shared.BillingCycleRelativeDateStartOfTerm)),
 			}}),
 		},
 	)