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-4dba22b15243ee155bdcb8f31cb608ff8c51a61f3d547cb9f2de449daab2e975.yml
-openapi_spec_hash: d12d72bf7a894a405055eec960566ba6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb/orb-ced53ed56f6606e257f0ffef08022b32a1ada8db02e7e65984382999d9e30349.yml
+openapi_spec_hash: 681faaa5f12a13cbe738898669a12017
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

src/resources/customers/credits/ledger.ts

@@ -155,8 +155,9 @@ export class Ledger extends APIResource {
    * }
    * ```
    *
-   * Note that by default, Orb will always first increment any _negative_ balance in
-   * existing blocks before adding the remaining amount to the desired credit block.
+   * Note that an `increment` entry always creates a new credit block (defined by the
+   * optional `effective_date` and `expiry_date`); it never modifies an existing
+   * block.
    *
    * ### Invoicing for credits
    *
@@ -288,8 +289,9 @@ export class Ledger extends APIResource {
    * }
    * ```
    *
-   * Note that by default, Orb will always first increment any _negative_ balance in
-   * existing blocks before adding the remaining amount to the desired credit block.
+   * Note that an `increment` entry always creates a new credit block (defined by the
+   * optional `effective_date` and `expiry_date`); it never modifies an existing
+   * block.
    *
    * ### Invoicing for credits
    *