diff --git a/schemas/paths/events.yaml b/schemas/paths/events.yaml
index 58d19445..79a149cc 100644
--- a/schemas/paths/events.yaml
+++ b/schemas/paths/events.yaml
@@ -227,34 +227,34 @@ get:
       in: query
       schema:
         oneOf:
-          - type: integer
-            format: int64
-            examples:
-              - 1767225600000
           - type: string
             format: date-time
             examples:
               - '2026-01-01T00:00:00Z'
+          - type: integer
+            format: int64
+            examples:
+              - 1767225600000
         examples:
           - '2026-01-01T00:00:00Z'
       description: |
-        Include events that happened after this point (with timestamp greater than or equal the provided `start` Unix milliseconds value or RFC3339 timestamp). Defaults to 7 days ago. Setting `start` does not change `end`'s default of `now` — adjust it separately if needed.
+        Include events that happened after the provided `start` date formatted as an RFC3339 timestamp. For backward compatibility, a Unix milliseconds timestamp is also accepted. Defaults to 7 days ago. Setting `start` does not change the default `end` date of `now` — adjust it separately if needed.
     - name: end
       in: query
       schema:
         oneOf:
-          - type: integer
-            format: int64
-            examples:
-              - 1769903999000
           - type: string
             format: date-time
             examples:
               - '2026-01-31T23:59:59Z'
+          - type: integer
+            format: int64
+            examples:
+              - 1769903999000
         examples:
           - '2026-01-31T23:59:59Z'
       description: |
-        Include events that happened before this point (with timestamp less than or equal the provided `end` Unix milliseconds value or RFC3339 timestamp). Defaults to now. Setting `end` does not change `start`'s default of `7 days ago` — adjust it separately if needed.
+        Include events that happened before the provided `end` date formatted as an RFC3339 timestamp. For backward compatibility, a Unix milliseconds timestamp is also accepted. Defaults to now. Setting `end` does not change the default `start` date of `7 days ago` — adjust it separately if needed.
     - name: reverse
       in: query
       schema: