diff --git a/.stats.yml b/.stats.yml
index f6e24a32..a9fd9444 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,2 +1,2 @@
 configured_endpoints: 103
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-04f02fa57c3ab8d15ecf0a16a41a83814c21cdc2a830fae4d65f1b7b2196d819.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-979330185e8fda7b2bc2440075fe81c66132fc87ff3c548e93dd05db35ba3172.yml
diff --git a/src/orb/resources/events/backfills.py b/src/orb/resources/events/backfills.py
index b3beb23d..6171fb5e 100644
--- a/src/orb/resources/events/backfills.py
+++ b/src/orb/resources/events/backfills.py
@@ -106,9 +106,13 @@ def create(
         based on both a period of time and specific property values.
 
         Args:
-          timeframe_end: The (exclusive) end of the usage timeframe affected by this backfill.
+          timeframe_end: The (exclusive) end of the usage timeframe affected by this backfill. By
+              default, Orb allows backfills up to 10 days in duration at a time. Reach out to
+              discuss extending this limit and your use case.
 
-          timeframe_start: The (inclusive) start of the usage timeframe affected by this backfill.
+          timeframe_start: The (inclusive) start of the usage timeframe affected by this backfill. By
+              default, Orb allows backfills up to 10 days in duration at a time. Reach out to
+              discuss extending this limit and your use case.
 
           close_time: The time at which no more events will be accepted for this backfill. The
               backfill will automatically begin reflecting throughout Orb at the close time.
@@ -418,9 +422,13 @@ async def create(
         based on both a period of time and specific property values.
 
         Args:
-          timeframe_end: The (exclusive) end of the usage timeframe affected by this backfill.
+          timeframe_end: The (exclusive) end of the usage timeframe affected by this backfill. By
+              default, Orb allows backfills up to 10 days in duration at a time. Reach out to
+              discuss extending this limit and your use case.
 
-          timeframe_start: The (inclusive) start of the usage timeframe affected by this backfill.
+          timeframe_start: The (inclusive) start of the usage timeframe affected by this backfill. By
+              default, Orb allows backfills up to 10 days in duration at a time. Reach out to
+              discuss extending this limit and your use case.
 
           close_time: The time at which no more events will be accepted for this backfill. The
               backfill will automatically begin reflecting throughout Orb at the close time.
diff --git a/src/orb/types/events/backfill_create_params.py b/src/orb/types/events/backfill_create_params.py
index 066a6f9a..138c0e0e 100644
--- a/src/orb/types/events/backfill_create_params.py
+++ b/src/orb/types/events/backfill_create_params.py
@@ -13,10 +13,18 @@
 
 class BackfillCreateParams(TypedDict, total=False):
     timeframe_end: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
-    """The (exclusive) end of the usage timeframe affected by this backfill."""
+    """The (exclusive) end of the usage timeframe affected by this backfill.
+
+    By default, Orb allows backfills up to 10 days in duration at a time. Reach out
+    to discuss extending this limit and your use case.
+    """
 
     timeframe_start: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
-    """The (inclusive) start of the usage timeframe affected by this backfill."""
+    """The (inclusive) start of the usage timeframe affected by this backfill.
+
+    By default, Orb allows backfills up to 10 days in duration at a time. Reach out
+    to discuss extending this limit and your use case.
+    """
 
     close_time: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
     """The time at which no more events will be accepted for this backfill.