fix(specs): insights-api timestamp documentation (generated)

algolia/api-clients-automation#5925

Co-authored-by: algolia-bot <accounts+algolia-api-client-bot@algolia.com>
Co-authored-by: Dave Sirockin <dave@sirockin.com>

Author: algolia-bot

algoliasearch/insights/models/added_to_cart_object_ids.py

@@ -65,7 +65,7 @@ class AddedToCartObjectIDs(BaseModel):
     object_data: Optional[List[ObjectData]] = None
     """ Extra information about the records involved in a purchase or add-to-cart event.  If specified, it must have the same length as `objectIDs`.  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
     value: Optional[Value] = None
 
     @field_validator("event_name")

algoliasearch/insights/models/added_to_cart_object_ids_after_search.py

@@ -68,7 +68,7 @@ class AddedToCartObjectIDsAfterSearch(BaseModel):
     object_data: Optional[List[ObjectDataAfterSearch]] = None
     """ Extra information about the records involved in a purchase or add-to-cart events.  If provided, it must be the same length as `objectIDs`.  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
     value: Optional[Value] = None
 
     @field_validator("event_name")

algoliasearch/insights/models/clicked_filters.py

@@ -53,7 +53,7 @@ class ClickedFilters(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/clicked_object_ids.py

@@ -53,7 +53,7 @@ class ClickedObjectIDs(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/clicked_object_ids_after_search.py

@@ -59,7 +59,7 @@ class ClickedObjectIDsAfterSearch(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/converted_filters.py

@@ -53,7 +53,7 @@ class ConvertedFilters(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/converted_object_ids.py

@@ -53,7 +53,7 @@ class ConvertedObjectIDs(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/converted_object_ids_after_search.py

@@ -56,7 +56,7 @@ class ConvertedObjectIDsAfterSearch(BaseModel):
     authenticated_user_token: Optional[str] = None
     """ Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don't use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
 
     @field_validator("event_name")
     def event_name_validate_regular_expression(cls, value):

algoliasearch/insights/models/purchased_object_ids.py

@@ -65,7 +65,7 @@ class PurchasedObjectIDs(BaseModel):
     object_data: Optional[List[ObjectData]] = None
     """ Extra information about the records involved in a purchase or add-to-cart event.  If specified, it must have the same length as `objectIDs`.  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
     value: Optional[Value] = None
 
     @field_validator("event_name")

algoliasearch/insights/models/purchased_object_ids_after_search.py

@@ -65,7 +65,7 @@ class PurchasedObjectIDsAfterSearch(BaseModel):
     object_data: List[ObjectDataAfterSearch]
     """ Extra information about the records involved in a purchase or add-to-cart events.  If provided, it must be the same length as `objectIDs`.  """
     timestamp: Optional[int] = None
-    """ Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.  """
+    """ Timestamp of the event, measured in milliseconds since the Unix epoch. Must be no older than 30 days. If not provided, we use the time at which the request was received.  """
     value: Optional[Value] = None
 
     @field_validator("event_name")