feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-a44cccd16bb58080f7cc0669999403f6ed3f77287fad901caa6fd2523f2fbafd.yml
-openapi_spec_hash: af6444648d0b2a70b7f7ad234bd37541
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-1aabbd8715a871e993abf67f0bf9c1d6793b4f197c4b2f11fc7a76453590cd6c.yml
+openapi_spec_hash: 3e5878f87e74881d882a69e1ccdc25a3
 config_hash: 1f535c1fa222aacf28b636eed21bec72

src/orb/resources/customers/costs.py

@@ -177,7 +177,7 @@ def list(
         `grouping_value` and `secondary_grouping_value` available.
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 
@@ -353,7 +353,7 @@ def list_by_external_id(
         `grouping_value` and `secondary_grouping_value` available.
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 
@@ -552,7 +552,7 @@ async def list(
         `grouping_value` and `secondary_grouping_value` available.
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 
@@ -728,7 +728,7 @@ async def list_by_external_id(
         `grouping_value` and `secondary_grouping_value` available.
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 

src/orb/resources/customers/customers.py

@@ -371,8 +371,11 @@ def update(
 
           email: A valid customer email, to be used for invoicing and notifications.
 
-          external_customer_id: The external customer ID. This can only be set if empty and the customer has no
-              past or current subscriptions.
+          external_customer_id: The external customer ID. This can only be set if the customer has no existing
+              external customer ID. Since this action may change usage quantities for all
+              existing subscriptions, it is disallowed if the customer has issued invoices
+              with usage line items and subject to the same restrictions as backdated
+              subscription creation.
 
           hierarchy: The hierarchical relationships for this customer.
 
@@ -880,8 +883,11 @@ def update_by_external_id(
 
           email: A valid customer email, to be used for invoicing and notifications.
 
-          external_customer_id: The external customer ID. This can only be set if empty and the customer has no
-              past or current subscriptions.
+          external_customer_id: The external customer ID. This can only be set if the customer has no existing
+              external customer ID. Since this action may change usage quantities for all
+              existing subscriptions, it is disallowed if the customer has issued invoices
+              with usage line items and subject to the same restrictions as backdated
+              subscription creation.
 
           hierarchy: The hierarchical relationships for this customer.
 
@@ -1370,8 +1376,11 @@ async def update(
 
           email: A valid customer email, to be used for invoicing and notifications.
 
-          external_customer_id: The external customer ID. This can only be set if empty and the customer has no
-              past or current subscriptions.
+          external_customer_id: The external customer ID. This can only be set if the customer has no existing
+              external customer ID. Since this action may change usage quantities for all
+              existing subscriptions, it is disallowed if the customer has issued invoices
+              with usage line items and subject to the same restrictions as backdated
+              subscription creation.
 
           hierarchy: The hierarchical relationships for this customer.
 
@@ -1879,8 +1888,11 @@ async def update_by_external_id(
 
           email: A valid customer email, to be used for invoicing and notifications.
 
-          external_customer_id: The external customer ID. This can only be set if empty and the customer has no
-              past or current subscriptions.
+          external_customer_id: The external customer ID. This can only be set if the customer has no existing
+              external customer ID. Since this action may change usage quantities for all
+              existing subscriptions, it is disallowed if the customer has issued invoices
+              with usage line items and subject to the same restrictions as backdated
+              subscription creation.
 
           hierarchy: The hierarchical relationships for this customer.
 

src/orb/resources/invoices.py

@@ -155,13 +155,13 @@ def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
         idempotency_key: str | None = None,
     ) -> Invoice:
-        """This endpoint allows you to update the `metadata` property on an invoice.
-
-        If you
-        pass null for the metadata value, it will clear any existing metadata for that
-        invoice.
+        """
+        This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
+        properties on an invoice. If you pass null for the metadata value, it will clear
+        any existing metadata for that invoice.
 
-        `metadata` can be modified regardless of invoice state.
+        `metadata` can be modified regardless of invoice state. `net_terms` and
+        `due_date` can only be modified if the invoice is in a `draft` state.
 
         Args:
           metadata: User-specified key/value pairs for the resource. Individual keys can be removed
@@ -695,13 +695,13 @@ async def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
         idempotency_key: str | None = None,
     ) -> Invoice:
-        """This endpoint allows you to update the `metadata` property on an invoice.
-
-        If you
-        pass null for the metadata value, it will clear any existing metadata for that
-        invoice.
+        """
+        This endpoint allows you to update the `metadata`, `net_terms`, and `due_date`
+        properties on an invoice. If you pass null for the metadata value, it will clear
+        any existing metadata for that invoice.
 
-        `metadata` can be modified regardless of invoice state.
+        `metadata` can be modified regardless of invoice state. `net_terms` and
+        `due_date` can only be modified if the invoice is in a `draft` state.
 
         Args:
           metadata: User-specified key/value pairs for the resource. Individual keys can be removed

src/orb/resources/subscriptions.py

@@ -833,7 +833,7 @@ def fetch_costs(
         same day).
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 
@@ -2919,7 +2919,7 @@ async def fetch_costs(
         same day).
 
         Args:
-          currency: The currency to use.
+          currency: The currency or custom pricing unit to use.
 
           timeframe_end: Costs returned are exclusive of `timeframe_end`.
 

src/orb/types/customer_update_by_external_id_params.py

@@ -49,8 +49,10 @@ class CustomerUpdateByExternalIDParams(TypedDict, total=False):
     external_customer_id: Optional[str]
     """The external customer ID.
 
-    This can only be set if empty and the customer has no past or current
-    subscriptions.
+    This can only be set if the customer has no existing external customer ID. Since
+    this action may change usage quantities for all existing subscriptions, it is
+    disallowed if the customer has issued invoices with usage line items and subject
+    to the same restrictions as backdated subscription creation.
     """
 
     hierarchy: Optional[CustomerHierarchyConfigParam]

src/orb/types/customer_update_params.py

@@ -49,8 +49,10 @@ class CustomerUpdateParams(TypedDict, total=False):
     external_customer_id: Optional[str]
     """The external customer ID.
 
-    This can only be set if empty and the customer has no past or current
-    subscriptions.
+    This can only be set if the customer has no existing external customer ID. Since
+    this action may change usage quantities for all existing subscriptions, it is
+    disallowed if the customer has issued invoices with usage line items and subject
+    to the same restrictions as backdated subscription creation.
     """
 
     hierarchy: Optional[CustomerHierarchyConfigParam]

src/orb/types/customers/cost_list_by_external_id_params.py

@@ -13,7 +13,7 @@
 
 class CostListByExternalIDParams(TypedDict, total=False):
     currency: Optional[str]
-    """The currency to use."""
+    """The currency or custom pricing unit to use."""
 
     timeframe_end: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
     """Costs returned are exclusive of `timeframe_end`."""

src/orb/types/customers/cost_list_params.py

@@ -13,7 +13,7 @@
 
 class CostListParams(TypedDict, total=False):
     currency: Optional[str]
-    """The currency to use."""
+    """The currency or custom pricing unit to use."""
 
     timeframe_end: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
     """Costs returned are exclusive of `timeframe_end`."""

src/orb/types/customers/credits/ledger_create_entry_by_external_id_params.py

@@ -81,7 +81,7 @@ class AddIncrementCreditLedgerEntryRequestParamsInvoiceSettings(TypedDict, total
     saved payment method.
     """
 
-    net_terms: Required[int]
+    net_terms: Required[Optional[int]]
     """
     The net terms determines the difference between the invoice date and the issue
     date for the invoice. If you intend the invoice to be due on issue, set this