Update OpenAPI specs to v240.5.2

openapi/chat-openapi-clientside.yaml

@@ -18901,7 +18901,7 @@ components:
       type: apiKey
 info:
   title: Stream API
-  version: v240.5.1
+  version: v240.5.2
   x-stream-breaking-changes:
     go:
     - CHA-3441 (2026-10-08)

openapi/chat-openapi.yaml

@@ -26625,7 +26625,7 @@ components:
       type: apiKey
 info:
   title: Stream API
-  version: v240.5.1
+  version: v240.5.2
   x-stream-breaking-changes:
     go:
     - CHA-3441 (2026-10-08)

openapi/clientside-api.yaml

@@ -1507,27 +1507,27 @@ components:
           format: int32
           title: Bookmark Count
           type: integer
-          x-stream-index: "035"
+          x-stream-index: "036"
         collections:
           additionalProperties:
             $ref: '#/components/schemas/EnrichedCollectionResponse'
           description: Enriched collection data referenced by this activity
           title: Collections
           type: object
-          x-stream-index: "044"
+          x-stream-index: "045"
         comment_count:
           description: Number of comments on the activity
           format: int32
           title: Comment Count
           type: integer
-          x-stream-index: "033"
+          x-stream-index: "034"
         comments:
           description: Latest 5 comments of this activity (comment replies excluded)
           items:
             $ref: '#/components/schemas/CommentResponse'
           title: Comments
           type: array
-          x-stream-index: "019"
+          x-stream-index: "020"
         created_at:
           description: When the activity was created
           format: date-time
@@ -1540,7 +1540,7 @@ components:
             only to one feed, it's always set. If an activity is added to multiple
             feeds, it's only set when calling the GetOrCreateFeed endpoint.
           title: Current Feed
-          x-stream-index: "047"
+          x-stream-index: "048"
         custom:
           additionalProperties: {}
           description: Custom data for the activity
@@ -1552,19 +1552,19 @@ components:
           format: date-time
           title: Deleted At
           type: number
-          x-stream-index: "026"
+          x-stream-index: "027"
         edited_at:
           description: When the activity was last edited
           format: date-time
           title: Edited At
           type: number
-          x-stream-index: "025"
+          x-stream-index: "026"
         expires_at:
           description: When the activity will expire
           format: date-time
           title: Expires At
           type: number
-          x-stream-index: "027"
+          x-stream-index: "028"
         feeds:
           description: List of feed IDs containing this activity
           items:
@@ -1578,31 +1578,31 @@ components:
             type: string
           title: Filter Tags
           type: array
-          x-stream-index: "029"
+          x-stream-index: "030"
         friend_reaction_count:
           description: Total count of reactions from friends on this activity
           format: int32
           title: Friend Reaction Count
           type: integer
-          x-stream-index: "046"
+          x-stream-index: "047"
         friend_reactions:
           description: Reactions from users the current user follows or has mutual
             follows with
           items:
             $ref: '#/components/schemas/FeedsReactionResponse'
           title: Friend Reactions
           type: array
-          x-stream-index: "045"
+          x-stream-index: "046"
         hidden:
           description: If this activity is hidden by this user (using activity feedback)
           title: Hidden
           type: boolean
-          x-stream-index: "048"
+          x-stream-index: "049"
         i18n:
           additionalProperties:
             type: string
           type: object
-          x-stream-index: "021"
+          x-stream-index: "022"
         id:
           description: Unique identifier for the activity
           title: ID
@@ -1614,41 +1614,41 @@ components:
             type: string
           title: Interest Tags
           type: array
-          x-stream-index: "030"
+          x-stream-index: "031"
         is_read:
           description: Whether this activity has been read. Only set for feed groups
             with notification config (track_seen/track_read enabled).
           title: Is Read
           type: boolean
-          x-stream-index: "052"
+          x-stream-index: "053"
         is_seen:
           description: Whether this activity has been seen. Only set for feed groups
             with notification config (track_seen/track_read enabled).
           title: Is Seen
           type: boolean
-          x-stream-index: "051"
+          x-stream-index: "052"
         is_watched:
           type: boolean
-          x-stream-index: "050"
+          x-stream-index: "051"
         latest_reactions:
           description: Recent reactions to the activity
           items:
             $ref: '#/components/schemas/FeedsReactionResponse'
           title: Latest Reactions
           type: array
-          x-stream-index: "039"
+          x-stream-index: "040"
         latest_shares:
           description: Recent shares of the activity, one entry per share (org-gated)
           items:
             $ref: '#/components/schemas/ShareResponse'
           title: Latest Shares
           type: array
-          x-stream-index: "040"
+          x-stream-index: "041"
         location:
           $ref: '#/components/schemas/Location'
           description: Geographic location related to the activity
           title: Location
-          x-stream-index: "022"
+          x-stream-index: "023"
         mentioned_users:
           description: Users mentioned in the activity
           items:
@@ -1661,15 +1661,15 @@ components:
             format: int64
             type: integer
           type: object
-          x-stream-index: "038"
+          x-stream-index: "039"
         moderation:
           $ref: '#/components/schemas/ModerationV2Response'
           description: Moderation information
           title: Moderation
-          x-stream-index: "031"
+          x-stream-index: "032"
         moderation_action:
           type: string
-          x-stream-index: "032"
+          x-stream-index: "033"
         notification_context:
           $ref: '#/components/schemas/NotificationContext'
           description: Notification context data for the activity (if this is a reaction,
@@ -1682,49 +1682,60 @@ components:
             $ref: '#/components/schemas/BookmarkResponse'
           title: Own Bookmarks
           type: array
-          x-stream-index: "043"
+          x-stream-index: "044"
         own_reactions:
           description: Current user's reactions to this activity
           items:
             $ref: '#/components/schemas/FeedsReactionResponse'
           title: Own Reactions
           type: array
-          x-stream-index: "042"
+          x-stream-index: "043"
         parent:
           $ref: '#/components/schemas/ActivityResponse'
           description: Parent activity (if this is a reply/comment)
           title: Parent
-          x-stream-index: "023"
+          x-stream-index: "024"
         poll:
           $ref: '#/components/schemas/PollResponseData'
           description: Poll attached to this activity
           title: Poll
-          x-stream-index: "024"
+          x-stream-index: "025"
         popularity:
           description: Popularity score of the activity
           format: int32
           title: Popularity
           type: integer
           x-stream-index: "014"
+        position:
+          description: 1-based position of this activity. On ranked feeds it is the
+            activity's slot in the ranked feed, continuing across pages; activities
+            filtered out for this user leave gaps. Otherwise it is relative to the
+            returned page. Only set on feed reads for paid plans with an authenticated
+            user, when the app uses feed impressions (For You exploration, or a For
+            You ranking that uses impressions_bucket).
+          format: int32
+          title: Position
+          type: integer
+          x-stream-index: "019"
         preview:
           description: If this activity is obfuscated for this user. For premium content
             where you want to show a preview
           title: Preview
           type: boolean
-          x-stream-index: "049"
+          x-stream-index: "050"
         reaction_count:
           description: Number of reactions to the activity
           format: int32
           title: Reaction Count
           type: integer
-          x-stream-index: "037"
+          x-stream-index: "038"
         reaction_groups:
           additionalProperties:
             $ref: '#/components/schemas/FeedsReactionGroupResponse'
           description: Grouped reactions by type
           title: Reaction Groups
           type: object
-          x-stream-index: "041"
+          x-stream-index: "042"
         reasons:
           description: Codes explaining why this activity was shown (e.g. 'following',
             'popular', 'interest:nba'). Only included when include_reasons is enabled
@@ -1760,11 +1771,11 @@ components:
           description: Data for search indexing
           title: Search Data
           type: object
-          x-stream-index: "028"
+          x-stream-index: "029"
         selector_source:
           description: Which activity selector provided this activity (e.g., 'following',
-            'popular', 'interest'). Only set when using multiple activity selectors
-            with ranking.
+            'popular', 'interest'), or 'exploration' for the For You exploration slot.
+            Only set when using multiple activity selectors with ranking.
           title: Selector Source
           type: string
           x-stream-index: "018"
@@ -1773,12 +1784,12 @@ components:
           format: int32
           title: Share Count
           type: integer
-          x-stream-index: "036"
+          x-stream-index: "037"
         text:
           description: Text content of the activity
           title: Text
           type: string
-          x-stream-index: "020"
+          x-stream-index: "021"
         top_level_comment_count:
           description: Number of top-level comments (comments directly on the activity,
             excluding replies). Only returned by GetActivity when include_top_level_comment_count=true;
@@ -1787,7 +1798,7 @@ components:
           format: int32
           title: Top Level Comment Count
           type: integer
-          x-stream-index: "034"
+          x-stream-index: "035"
         type:
           description: Type of activity
           title: Type
@@ -19197,7 +19208,7 @@ components:
           x-stream-index: "003"
         created:
           type: boolean
-          x-stream-index: "014"
+          x-stream-index: "015"
         degraded_selectors:
           description: Activity selectors dropped from this read because they exceeded
             their time budget (see the time_budget_ms selector setting). Their activities
@@ -19212,7 +19223,7 @@ components:
           description: Duration of the request in milliseconds
           title: Duration
           type: string
-          x-stream-index: "016.001"
+          x-stream-index: "017.001"
         feed:
           $ref: '#/components/schemas/FeedResponse'
           x-stream-index: "001"
@@ -19242,7 +19253,7 @@ components:
           x-stream-index: "004"
         next:
           type: string
-          x-stream-index: "015.001"
+          x-stream-index: "016.001"
         notification_status:
           $ref: '#/components/schemas/NotificationStatusResponse'
           x-stream-index: "011"
@@ -19253,7 +19264,15 @@ components:
           x-stream-index: "007"
         prev:
           type: string
-          x-stream-index: "015.002"
+          x-stream-index: "016.002"
+        request_id:
+          description: Signed token identifying this read. Pass it with activity metrics
+            events to attribute them to this read. Only set on feed reads for paid
+            plans with an authenticated user, when the app uses feed impressions (For
+            You exploration, or a For You ranking that uses impressions_bucket)
+          title: Request ID
+          type: string
+          x-stream-index: "014"
       required:
       - feed
       - activities
@@ -39526,13 +39545,36 @@ components:
           title: Delta
           type: integer
           x-stream-index: "003"
+        dwell_ms:
+          description: Milliseconds the activity was in view. Required for the built-in
+            dwell metric; apps with a custom dwell metric keep their own behavior.
+          format: int64
+          title: Dwell (ms)
+          type: integer
+          x-stream-index: "006"
         metric:
-          description: The metric name (e.g. views, clicks, impressions). Alphanumeric
-            and underscores only.
+          description: The metric name (e.g. views, clicks, impressions, dwell). Alphanumeric
+            and underscores only. dwell requires dwell_ms.
           maxLength: 64
           title: Metric
           type: string
           x-stream-index: "002"
+        position:
+          description: 1-based position of the activity in that feed read. A value
+            below 1 fails only this event. Accepted but not stored yet.
+          format: int32
+          title: Position
+          type: integer
+          x-stream-index: "005"
+        request_id:
+          description: The request_id returned by the feed read that showed the activity.
+            An invalid, expired (older than 48h) or future-dated (more than 5 minutes
+            ahead) value fails only this event. Impressions sent with a valid request_id
+            feed ranking, are not added to the activity's metrics.impressions, and
+            must use a delta of 1.
+          title: Request ID
+          type: string
+          x-stream-index: "004"
       required:
       - activity_id
       - metric
@@ -45395,7 +45437,7 @@ components:
       type: apiKey
 info:
   title: Stream API
-  version: v240.5.1
+  version: v240.5.2
   x-stream-breaking-changes:
     go:
     - CHA-3441 (2026-10-08)

openapi/moderation-clientside-api.yaml

@@ -10062,7 +10062,7 @@ components:
       type: apiKey
 info:
   title: Stream API
-  version: v240.5.1
+  version: v240.5.2
   x-stream-breaking-changes:
     go:
     - CHA-3441 (2026-10-08)