Add date-range caveat to first_open and first_series_disengagement field descriptions (#563)

* Add date-range caveat to first_open and first_series_disengagement fields

Append "Only events within the export job's requested date range are counted." to the description of these two export stats fields across all spec versions.

- intercom/developer-docs#991

* Extend date-range caveat to all first_* export receipt fields

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: steve-henry

descriptions/0/api.intercom.io.yaml

@@ -32361,43 +32361,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
     deleted_article_object:
       title: Deleted Article Object
       type: object

descriptions/2.10/api.intercom.io.yaml

@@ -14719,43 +14719,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
     deleted_article_object:
       title: Deleted Article Object
       type: object

descriptions/2.11/api.intercom.io.yaml

@@ -15582,43 +15582,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
       required:
         - user_id
         - company_id

descriptions/2.12/api.intercom.io.yaml

@@ -15994,43 +15994,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
     deleted_article_object:
       title: Deleted Article Object
       type: object

descriptions/2.13/api.intercom.io.yaml

@@ -17460,43 +17460,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
     deleted_article_object:
       title: Deleted Article Object
       type: object

descriptions/2.14/api.intercom.io.yaml

@@ -19306,43 +19306,44 @@ components:
         first_reply:
           type: integer
           description: The first time a user replied to this message if the content
-            was able to receive replies.
+            was able to receive replies. Only events within the export job's requested date range are counted.
         first_completion:
           type: integer
           description: The first time a user completed this message if the content
-            was able to be completed e.g. Tours, Surveys.
+            was able to be completed e.g. Tours, Surveys. Only events within the export job's requested date range are counted.
         first_series_completion:
           type: integer
           description: The first time the series this message was a part of was completed
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_disengagement:
           type: integer
           description: The first time the series this message was a part of was disengaged
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_series_exit:
           type: integer
           description: The first time the series this message was a part of was exited
-            by the user.
+            by the user. Only events within the export job's requested date range are counted.
         first_goal_success:
           type: integer
           description: The first time the user met this messages associated goal if
-            one exists.
+            one exists. Only events within the export job's requested date range are counted.
         first_open:
           type: integer
-          description: The first time the user opened this message.
+          description: The first time the user opened this message. Only events within
+            the export job's requested date range are counted.
         first_click:
           type: integer
           description: The first time the series the user clicked on a link within
-            this message.
+            this message. Only events within the export job's requested date range are counted.
         first_dismisall:
           type: integer
-          description: The first time the series the user dismissed this message.
+          description: The first time the series the user dismissed this message. Only events within the export job's requested date range are counted.
         first_unsubscribe:
           type: integer
-          description: The first time the user unsubscribed from this message.
+          description: The first time the user unsubscribed from this message. Only events within the export job's requested date range are counted.
         first_hard_bounce:
           type: integer
-          description: The first time this message hard bounced for this user
+          description: The first time this message hard bounced for this user. Only events within the export job's requested date range are counted.
     deleted_article_object:
       title: Deleted Article Object
       type: object