diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 68f9449d..ff202757 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "5.7.0"
+  ".": "5.8.0"
 }
diff --git a/.stats.yml b/.stats.yml
index f4571777..43e82626 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 118
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-d63c8075b48441663736b457f8ad859c58cc3e31dfbffb68db44c3f00562012c.yml
-openapi_spec_hash: c47dbff685a0a449bfc1ad729c13a72e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-2c9291de1fd876908ebe56144e90762ab6e390e3f25102da815ab3fca6335d38.yml
+openapi_spec_hash: eabe2d8e58ceed1d61d41fe7a44020ca
 config_hash: 1f73a949b649ecfe6ec68ba1bb459dc2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7ac97e9d..fd139f61 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 5.8.0 (2025-09-10)
+
+Full Changelog: [v5.7.0...v5.8.0](https://github.com/orbcorp/orb-node/compare/v5.7.0...v5.8.0)
+
+### Features
+
+* **api:** api update ([6a58d8d](https://github.com/orbcorp/orb-node/commit/6a58d8d8e06e7799683ff888ea2c4123dd78d00e))
+
 ## 5.7.0 (2025-09-08)
 
 Full Changelog: [v5.6.0...v5.7.0](https://github.com/orbcorp/orb-node/compare/v5.6.0...v5.7.0)
diff --git a/package.json b/package.json
index 0e263b61..f7569e9b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "orb-billing",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "description": "The official TypeScript library for the Orb API",
   "author": "Orb <team@withorb.com>",
   "types": "dist/index.d.ts",
diff --git a/src/resources/prices/prices.ts b/src/resources/prices/prices.ts
index 7d11b930..37c06497 100644
--- a/src/resources/prices/prices.ts
+++ b/src/resources/prices/prices.ts
@@ -988,7 +988,9 @@ export declare namespace PriceCreateParams {
 
       /**
        * Apply tiered pricing after rounding up the quantity to the package size. Tiers
-       * are defined using exclusive lower bounds.
+       * are defined using exclusive lower bounds. The tier bounds are defined based on
+       * the total quantity rather than the number of packages, so they must be multiples
+       * of the package size.
        */
       tiers: Array<TieredPackageConfig.Tier>;
     }
diff --git a/src/resources/shared.ts b/src/resources/shared.ts
index 28468465..28ae930a 100644
--- a/src/resources/shared.ts
+++ b/src/resources/shared.ts
@@ -4326,7 +4326,9 @@ export namespace NewFloatingTieredPackagePrice {
 
     /**
      * Apply tiered pricing after rounding up the quantity to the package size. Tiers
-     * are defined using exclusive lower bounds.
+     * are defined using exclusive lower bounds. The tier bounds are defined based on
+     * the total quantity rather than the number of packages, so they must be multiples
+     * of the package size.
      */
     tiers: Array<TieredPackageConfig.Tier>;
   }
@@ -7741,7 +7743,9 @@ export namespace NewPlanTieredPackagePrice {
 
     /**
      * Apply tiered pricing after rounding up the quantity to the package size. Tiers
-     * are defined using exclusive lower bounds.
+     * are defined using exclusive lower bounds. The tier bounds are defined based on
+     * the total quantity rather than the number of packages, so they must be multiples
+     * of the package size.
      */
     tiers: Array<TieredPackageConfig.Tier>;
   }
@@ -9566,7 +9570,9 @@ export namespace Price {
 
       /**
        * Apply tiered pricing after rounding up the quantity to the package size. Tiers
-       * are defined using exclusive lower bounds.
+       * are defined using exclusive lower bounds. The tier bounds are defined based on
+       * the total quantity rather than the number of packages, so they must be multiples
+       * of the package size.
        */
       tiers: Array<TieredPackageConfig.Tier>;
     }
diff --git a/src/resources/subscriptions.ts b/src/resources/subscriptions.ts
index 269a540f..4bb2c27e 100644
--- a/src/resources/subscriptions.ts
+++ b/src/resources/subscriptions.ts
@@ -3551,7 +3551,9 @@ export namespace NewSubscriptionTieredPackagePrice {
 
     /**
      * Apply tiered pricing after rounding up the quantity to the package size. Tiers
-     * are defined using exclusive lower bounds.
+     * are defined using exclusive lower bounds. The tier bounds are defined based on
+     * the total quantity rather than the number of packages, so they must be multiples
+     * of the package size.
      */
     tiers: Array<TieredPackageConfig.Tier>;
   }
diff --git a/src/version.ts b/src/version.ts
index 3d370464..acc2084a 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '5.7.0'; // x-release-please-version
+export const VERSION = '5.8.0'; // x-release-please-version