fix(specs): insights-api timestamp documentation (#5925)

sirockin · web-flow · commit 799a10c443a9 · 2026-02-06T16:02:40.000Z
diff --git a/specs/insights/common/schemas/EventAttributes.yml b/specs/insights/common/schemas/EventAttributes.yml
@@ -45,8 +45,8 @@ timestamp:
   type: integer
   format: int64
   description: |
-    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.
   example: 1687193127
 
 queryID:
diff --git a/specs/insights/paths/pushEvents.yml b/specs/insights/paths/pushEvents.yml
@@ -380,7 +380,7 @@ post:
               summary: Timestamp too old
               value:
                 status: 422
-                message: The timestamp must be at most 4 days in the past
+                message: The timestamp is too far in the past
             TooManyEvents:
               summary: Too many events
               description: You can include up to 1,000 events in a single API request.
