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%2Forb-6d5fe70daa99c4f8480b388e828d125c42f6ff501f5b8030832ec487c6c929f0.yml
-openapi_spec_hash: 3ba772cb9926acc8b92881b311fd8685
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-eeffebaca8ce42919ea1e0b3b088c0adc197088c8cd6f46cd6339ed72a9e5058.yml
+openapi_spec_hash: a9669b75ec8e699410f2dacd164168e4
 config_hash: c01c1191b1cd696c7ca855ff6d28a8df

src/Orb/Models/Customers/Credits/Ledger/LedgerCreateEntryByExternalIDParams.cs

@@ -2225,9 +2225,9 @@ public JsonElement EntryType
     }
 
     /// <summary>
-    /// A future date (specified in YYYY-MM-DD format) used for expiration change,
-    /// denoting when credits transferred (as part of a partial block expiration)
-    /// should expire.
+    /// A date (specified in YYYY-MM-DD format) used for expiration change, denoting
+    /// when credits transferred (as part of a partial block expiration) should expire.
+    /// This date must be on or after the effective date of the credit block.
     /// </summary>
     public required string TargetExpiryDate
     {

src/Orb/Models/Customers/Credits/Ledger/LedgerCreateEntryParams.cs

@@ -2008,9 +2008,9 @@ public JsonElement EntryType
     }
 
     /// <summary>
-    /// A future date (specified in YYYY-MM-DD format) used for expiration change,
-    /// denoting when credits transferred (as part of a partial block expiration)
-    /// should expire.
+    /// A date (specified in YYYY-MM-DD format) used for expiration change, denoting
+    /// when credits transferred (as part of a partial block expiration) should expire.
+    /// This date must be on or after the effective date of the credit block.
     /// </summary>
     public required string TargetExpiryDate
     {

src/Orb/Models/Invoices/InvoiceListParams.cs

@@ -25,6 +25,10 @@ namespace Orb.Models.Invoices;
 /// values for each draft invoice, which may not always be up-to-date since Orb regularly
 /// refreshes invoices asynchronously.</para>
 ///
+/// <para>If you don't need line item details, minimums, maximums, or discounts, prefer
+/// the [list invoices summary](/api-reference/invoice/list-invoices-summary) endpoint
+/// for better performance.</para>
+///
 /// <para>NOTE: Do not inherit from this type outside the SDK unless you're okay with
 /// breaking changes in non-major versions. We may add new methods in the future that
 /// cause existing derived classes to break.</para>

src/Orb/Services/IInvoiceService.cs

@@ -78,6 +78,10 @@ Task<Invoice> Update(
     /// <para>When fetching any `draft` invoices, this returns the last-computed invoice
     /// values for each draft invoice, which may not always be up-to-date since Orb
     /// regularly refreshes invoices asynchronously.</para>
+    ///
+    /// <para>If you don't need line item details, minimums, maximums, or discounts,
+    /// prefer the [list invoices summary](/api-reference/invoice/list-invoices-summary)
+    /// endpoint for better performance.</para>
     /// </summary>
     Task<InvoiceListPage> List(
         InvoiceListParams? parameters = null,