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

client/src/commonMain/kotlin/com/algolia/client/model/insights/AddedToCartObjectIDs.kt

@@ -33,8 +33,8 @@ import kotlinx.serialization.json.*
  * @param currency Three-letter [currency code](https://www.iso.org/iso-4217-currency-codes.html).
  * @param objectData Extra information about the records involved in a purchase or add-to-cart
  *   event. If specified, it must have the same length as `objectIDs`.
- * @param timestamp 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.
+ * @param 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.
  * @param `value`
  */
 @Serializable
@@ -82,8 +82,8 @@ public data class AddedToCartObjectIDs(
   @SerialName(value = "objectData") val objectData: List<ObjectData>? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
   @SerialName(value = "value") val `value`: Value? = null,

client/src/commonMain/kotlin/com/algolia/client/model/insights/AddedToCartObjectIDsAfterSearch.kt

@@ -34,8 +34,8 @@ import kotlinx.serialization.json.*
  * @param currency Three-letter [currency code](https://www.iso.org/iso-4217-currency-codes.html).
  * @param objectData Extra information about the records involved in a purchase or add-to-cart
  *   events. If provided, it must be the same length as `objectIDs`.
- * @param timestamp 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.
+ * @param 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.
  * @param `value`
  */
 @Serializable
@@ -90,8 +90,8 @@ public data class AddedToCartObjectIDsAfterSearch(
   @SerialName(value = "objectData") val objectData: List<ObjectDataAfterSearch>? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
   @SerialName(value = "value") val `value`: Value? = null,

client/src/commonMain/kotlin/com/algolia/client/model/insights/ClickedFilters.kt

@@ -27,8 +27,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ClickedFilters(
@@ -68,8 +68,8 @@ public data class ClickedFilters(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/ClickedObjectIDs.kt

@@ -28,8 +28,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ClickedObjectIDs(
@@ -66,8 +66,8 @@ public data class ClickedObjectIDs(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/ClickedObjectIDsAfterSearch.kt

@@ -32,8 +32,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ClickedObjectIDsAfterSearch(
@@ -83,8 +83,8 @@ public data class ClickedObjectIDsAfterSearch(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/ConvertedFilters.kt

@@ -27,8 +27,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ConvertedFilters(
@@ -68,8 +68,8 @@ public data class ConvertedFilters(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/ConvertedObjectIDs.kt

@@ -29,8 +29,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ConvertedObjectIDs(
@@ -67,8 +67,8 @@ public data class ConvertedObjectIDs(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/ConvertedObjectIDsAfterSearch.kt

@@ -32,8 +32,8 @@ import kotlinx.serialization.json.*
  *   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).
- * @param timestamp 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.
+ * @param 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.
  */
 @Serializable
 public data class ConvertedObjectIDsAfterSearch(
@@ -77,8 +77,8 @@ public data class ConvertedObjectIDsAfterSearch(
   @SerialName(value = "authenticatedUserToken") val authenticatedUserToken: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
 ) : EventsItems {}

client/src/commonMain/kotlin/com/algolia/client/model/insights/PurchasedObjectIDs.kt

@@ -32,8 +32,8 @@ import kotlinx.serialization.json.*
  * @param currency Three-letter [currency code](https://www.iso.org/iso-4217-currency-codes.html).
  * @param objectData Extra information about the records involved in a purchase or add-to-cart
  *   event. If specified, it must have the same length as `objectIDs`.
- * @param timestamp 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.
+ * @param 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.
  * @param `value`
  */
 @Serializable
@@ -81,8 +81,8 @@ public data class PurchasedObjectIDs(
   @SerialName(value = "objectData") val objectData: List<ObjectData>? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
   @SerialName(value = "value") val `value`: Value? = null,

client/src/commonMain/kotlin/com/algolia/client/model/insights/PurchasedObjectIDsAfterSearch.kt

@@ -31,8 +31,8 @@ import kotlinx.serialization.json.*
  *   For more information, see
  *   [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).
  * @param currency Three-letter [currency code](https://www.iso.org/iso-4217-currency-codes.html).
- * @param timestamp 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.
+ * @param 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.
  * @param `value`
  */
 @Serializable
@@ -80,8 +80,8 @@ public data class PurchasedObjectIDsAfterSearch(
   @SerialName(value = "currency") val currency: String? = null,
 
   /**
-   * 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.
    */
   @SerialName(value = "timestamp") val timestamp: Long? = null,
   @SerialName(value = "value") val `value`: Value? = null,