getstream-ruby 2.1.0 → 3.0.0

data/lib/getstream_ruby/generated/common_client.rb

@@ -1027,6 +1027,175 @@ module GetStream
         )
       end
 
+      # Lists user groups with cursor-based pagination
+      #
+      # @param limit [Integer]
+      # @param id_gt [String]
+      # @param created_at_gt [String]
+      # @param team_id [String]
+      # @return [Models::ListUserGroupsResponse]
+      def list_user_groups(limit = nil, id_gt = nil, created_at_gt = nil, team_id = nil)
+        path = '/api/v2/usergroups'
+        # Build query parameters
+        query_params = {}
+        query_params['limit'] = limit unless limit.nil?
+        query_params['id_gt'] = id_gt unless id_gt.nil?
+        query_params['created_at_gt'] = created_at_gt unless created_at_gt.nil?
+        query_params['team_id'] = team_id unless team_id.nil?
+
+        # Make the API request
+        @client.make_request(
+          :get,
+          path,
+          query_params: query_params
+        )
+      end
+
+      # Creates a new user group, optionally with initial members
+      #
+      # @param create_user_group_request [CreateUserGroupRequest]
+      # @return [Models::CreateUserGroupResponse]
+      def create_user_group(create_user_group_request)
+        path = '/api/v2/usergroups'
+        # Build request body
+        body = create_user_group_request
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path,
+          body: body
+        )
+      end
+
+      # Searches user groups by name prefix for autocomplete
+      #
+      # @param query [String]
+      # @param limit [Integer]
+      # @param name_gt [String]
+      # @param id_gt [String]
+      # @param team_id [String]
+      # @return [Models::SearchUserGroupsResponse]
+      def search_user_groups(query, limit = nil, name_gt = nil, id_gt = nil, team_id = nil)
+        path = '/api/v2/usergroups/search'
+        # Build query parameters
+        query_params = {}
+        query_params['query'] = query unless query.nil?
+        query_params['limit'] = limit unless limit.nil?
+        query_params['name_gt'] = name_gt unless name_gt.nil?
+        query_params['id_gt'] = id_gt unless id_gt.nil?
+        query_params['team_id'] = team_id unless team_id.nil?
+
+        # Make the API request
+        @client.make_request(
+          :get,
+          path,
+          query_params: query_params
+        )
+      end
+
+      # Deletes a user group and all its members
+      #
+      # @param _id [String]
+      # @param team_id [String]
+      # @return [Models::Response]
+      def delete_user_group(_id, team_id = nil)
+        path = '/api/v2/usergroups/{id}'
+        # Replace path parameters
+        path = path.gsub('{id}', _id.to_s)
+        # Build query parameters
+        query_params = {}
+        query_params['team_id'] = team_id unless team_id.nil?
+
+        # Make the API request
+        @client.make_request(
+          :delete,
+          path,
+          query_params: query_params
+        )
+      end
+
+      # Gets a user group by ID, including its members
+      #
+      # @param _id [String]
+      # @param team_id [String]
+      # @return [Models::GetUserGroupResponse]
+      def get_user_group(_id, team_id = nil)
+        path = '/api/v2/usergroups/{id}'
+        # Replace path parameters
+        path = path.gsub('{id}', _id.to_s)
+        # Build query parameters
+        query_params = {}
+        query_params['team_id'] = team_id unless team_id.nil?
+
+        # Make the API request
+        @client.make_request(
+          :get,
+          path,
+          query_params: query_params
+        )
+      end
+
+      # Updates a user group's name and/or description. team_id is immutable.
+      #
+      # @param _id [String]
+      # @param update_user_group_request [UpdateUserGroupRequest]
+      # @return [Models::UpdateUserGroupResponse]
+      def update_user_group(_id, update_user_group_request)
+        path = '/api/v2/usergroups/{id}'
+        # Replace path parameters
+        path = path.gsub('{id}', _id.to_s)
+        # Build request body
+        body = update_user_group_request
+
+        # Make the API request
+        @client.make_request(
+          :put,
+          path,
+          body: body
+        )
+      end
+
+      # Adds members to a user group. All user IDs must exist. The operation is all-or-nothing.
+      #
+      # @param _id [String]
+      # @param add_user_group_members_request [AddUserGroupMembersRequest]
+      # @return [Models::AddUserGroupMembersResponse]
+      def add_user_group_members(_id, add_user_group_members_request)
+        path = '/api/v2/usergroups/{id}/members'
+        # Replace path parameters
+        path = path.gsub('{id}', _id.to_s)
+        # Build request body
+        body = add_user_group_members_request
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path,
+          body: body
+        )
+      end
+
+      # Removes members from a user group. Users already not in the group are silently ignored.
+      #
+      # @param _id [String]
+      # @param remove_user_group_members_request [RemoveUserGroupMembersRequest]
+      # @return [Models::RemoveUserGroupMembersResponse]
+      def remove_user_group_members(_id, remove_user_group_members_request)
+        path = '/api/v2/usergroups/{id}/members/delete'
+        # Replace path parameters
+        path = path.gsub('{id}', _id.to_s)
+        # Build request body
+        body = remove_user_group_members_request
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path,
+          body: body
+        )
+      end
+
       # Find and filter users
       #
       # @param payload [QueryUsersPayload]
@@ -1045,7 +1214,7 @@ module GetStream
         )
       end
 
-      # Updates certain fields of the userSends events:- user.presence.changed- user.updated- user.presence.changed
+      # Updates certain fields of the userSends events:- user.presence.changed- user.updated
       #
       # @param update_users_partial_request [UpdateUsersPartialRequest]
       # @return [Models::UpdateUsersResponse]
@@ -1188,7 +1357,7 @@ module GetStream
         )
       end
 
-      # Reactivate users in batchesSends events:- user.reactivated- user.reactivated
+      # Reactivate users in batchesSends events:- user.reactivated
       #
       # @param reactivate_users_request [ReactivateUsersRequest]
       # @return [Models::ReactivateUsersResponse]

data/lib/getstream_ruby/generated/feed.rb

@@ -60,11 +60,13 @@ module GetStream
       # Unpin an activity from a feed. This removes the pin, so the activity will no longer be displayed at the top of the feed.
       #
       # @param activity_id [String]
+      # @param enrich_own_fields [Boolean]
       # @param user_id [String]
       # @return [Models::UnpinActivityResponse]
-      def unpin_activity(activity_id, user_id = nil)
+      def unpin_activity(activity_id, enrich_own_fields = nil, user_id = nil)
         # Build query parameters
         query_params = {}
+        query_params['enrich_own_fields'] = enrich_own_fields unless enrich_own_fields.nil?
         query_params['user_id'] = user_id unless user_id.nil?
 
         # Delegate to the FeedsClient
@@ -122,6 +124,16 @@ module GetStream
         @client.feeds.reject_feed_member_invite(@feed_group_id, @feed_id, reject_feed_member_invite_request)
       end
 
+      # Query pinned activities for a feed with filter query
+      #
+      # @param query_pinned_activities_request [QueryPinnedActivitiesRequest]
+      # @return [Models::QueryPinnedActivitiesResponse]
+      def query_pinned_activities(query_pinned_activities_request)
+
+        # Delegate to the FeedsClient
+        @client.feeds.query_pinned_activities(@feed_group_id, @feed_id, query_pinned_activities_request)
+      end
+
     end
   end
 end

data/lib/getstream_ruby/generated/feeds_client.rb

@@ -46,6 +46,23 @@ module GetStream
         )
       end
 
+      # Updates certain fields of multiple activities in a batch. Use 'set' to update specific fields and 'unset' to remove fields. Activities that fail due to not found, permission denied, or no changes detected are silently skipped and not included in the response. However, validation errors (e.g., updating reserved fields, invalid field values) will fail the entire batch request.Sends events:- feeds.activity.updated
+      #
+      # @param update_activities_partial_batch_request [UpdateActivitiesPartialBatchRequest]
+      # @return [Models::UpdateActivitiesPartialBatchResponse]
+      def update_activities_partial_batch(update_activities_partial_batch_request)
+        path = '/api/v2/feeds/activities/batch/partial'
+        # Build request body
+        body = update_activities_partial_batch_request
+
+        # Make the API request
+        @client.make_request(
+          :patch,
+          path,
+          body: body
+        )
+      end
+
       # Delete one or more activities by their IDs
       #
       # @param delete_activities_request [DeleteActivitiesRequest]
@@ -63,6 +80,23 @@ module GetStream
         )
       end
 
+      # Track metric events (views, clicks, impressions) for activities. Supports batching up to 100 events per request. Each event is independently rate-limited per user per activity per metric. Server-side calls must include user_id.
+      #
+      # @param track_activity_metrics_request [TrackActivityMetricsRequest]
+      # @return [Models::TrackActivityMetricsResponse]
+      def track_activity_metrics(track_activity_metrics_request)
+        path = '/api/v2/feeds/activities/metrics/track'
+        # Build request body
+        body = track_activity_metrics_request
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path,
+          body: body
+        )
+      end
+
       # Query activities based on filters with pagination and sorting options
       #
       # @param query_activities_request [QueryActivitiesRequest]
@@ -358,11 +392,15 @@ module GetStream
       #
       # @param _id [String]
       # @param restore_activity_request [RestoreActivityRequest]
+      # @param enrich_own_fields [Boolean]
       # @return [Models::RestoreActivityResponse]
-      def restore_activity(_id, restore_activity_request)
+      def restore_activity(_id, restore_activity_request, enrich_own_fields = nil)
         path = '/api/v2/feeds/activities/{id}/restore'
         # Replace path parameters
         path = path.gsub('{id}', _id.to_s)
+        # Build query parameters
+        query_params = {}
+        query_params['enrich_own_fields'] = enrich_own_fields unless enrich_own_fields.nil?
         # Build request body
         body = restore_activity_request
 
@@ -370,6 +408,7 @@ module GetStream
         @client.make_request(
           :post,
           path,
+          query_params: query_params,
           body: body
         )
       end
@@ -464,15 +503,15 @@ module GetStream
 
       # Read collections with optional filtering by user ID and collection name. By default, users can only read their own collections.
       #
-      # @param collection_refs [Array<String>]
       # @param user_id [String]
+      # @param collection_refs [Array<String>]
       # @return [Models::ReadCollectionsResponse]
-      def read_collections(collection_refs, user_id = nil)
+      def read_collections(user_id = nil, collection_refs = nil)
         path = '/api/v2/feeds/collections'
         # Build query parameters
         query_params = {}
-        query_params['collection_refs'] = collection_refs unless collection_refs.nil?
         query_params['user_id'] = user_id unless user_id.nil?
+        query_params['collection_refs'] = collection_refs unless collection_refs.nil?
 
         # Make the API request
         @client.make_request(
@@ -904,9 +943,10 @@ module GetStream
       # @param feed_group_id [String]
       # @param feed_id [String]
       # @param activity_id [String]
+      # @param enrich_own_fields [Boolean]
       # @param user_id [String]
       # @return [Models::UnpinActivityResponse]
-      def unpin_activity(feed_group_id, feed_id, activity_id, user_id = nil)
+      def unpin_activity(feed_group_id, feed_id, activity_id, enrich_own_fields = nil, user_id = nil)
         path = '/api/v2/feeds/feed_groups/{feed_group_id}/feeds/{feed_id}/activities/{activity_id}/pin'
         # Replace path parameters
         path = path.gsub('{feed_group_id}', feed_group_id.to_s)
@@ -914,6 +954,7 @@ module GetStream
         path = path.gsub('{activity_id}', activity_id.to_s)
         # Build query parameters
         query_params = {}
+        query_params['enrich_own_fields'] = enrich_own_fields unless enrich_own_fields.nil?
         query_params['user_id'] = user_id unless user_id.nil?
 
         # Make the API request
@@ -1036,6 +1077,28 @@ module GetStream
         )
       end
 
+      # Query pinned activities for a feed with filter query
+      #
+      # @param feed_group_id [String]
+      # @param feed_id [String]
+      # @param query_pinned_activities_request [QueryPinnedActivitiesRequest]
+      # @return [Models::QueryPinnedActivitiesResponse]
+      def query_pinned_activities(feed_group_id, feed_id, query_pinned_activities_request)
+        path = '/api/v2/feeds/feed_groups/{feed_group_id}/feeds/{feed_id}/pinned_activities/query'
+        # Replace path parameters
+        path = path.gsub('{feed_group_id}', feed_group_id.to_s)
+        path = path.gsub('{feed_id}', feed_id.to_s)
+        # Build request body
+        body = query_pinned_activities_request
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path,
+          body: body
+        )
+      end
+
       # Get follow suggestions for a feed group
       #
       # @param feed_group_id [String]
@@ -1059,6 +1122,22 @@ module GetStream
         )
       end
 
+      # Restores a soft-deleted feed group by its ID. Only clears DeletedAt in the database; no other fields are updated.
+      #
+      # @param feed_group_id [String]
+      # @return [Models::RestoreFeedGroupResponse]
+      def restore_feed_group(feed_group_id)
+        path = '/api/v2/feeds/feed_groups/{feed_group_id}/restore'
+        # Replace path parameters
+        path = path.gsub('{feed_group_id}', feed_group_id.to_s)
+
+        # Make the API request
+        @client.make_request(
+          :post,
+          path
+        )
+      end
+
       # Delete a feed group by its ID. Can perform a soft delete (default) or hard delete.
       #
       # @param _id [String]
@@ -1510,8 +1589,9 @@ module GetStream
       # @param source [String]
       # @param target [String]
       # @param delete_notification_activity [Boolean]
+      # @param enrich_own_fields [Boolean]
       # @return [Models::UnfollowResponse]
-      def unfollow(source, target, delete_notification_activity = nil)
+      def unfollow(source, target, delete_notification_activity = nil, enrich_own_fields = nil)
         path = '/api/v2/feeds/follows/{source}/{target}'
         # Replace path parameters
         path = path.gsub('{source}', source.to_s)
@@ -1519,6 +1599,7 @@ module GetStream
         # Build query parameters
         query_params = {}
         query_params['delete_notification_activity'] = delete_notification_activity unless delete_notification_activity.nil?
+        query_params['enrich_own_fields'] = enrich_own_fields unless enrich_own_fields.nil?
 
         # Make the API request
         @client.make_request(

data/lib/getstream_ruby/generated/models/activity_feedback_event_payload.rb

@@ -10,7 +10,7 @@ module GetStream
 
         # Model attributes
         # @!attribute action
-        #   @return [String] The type of feedback action
+        #   @return [String] The type of feedback action. One of: hide, show_more, show_less
         attr_accessor :action
         # @!attribute activity_id
         #   @return [String] The activity that received feedback

data/lib/getstream_ruby/generated/models/activity_request.rb

@@ -15,6 +15,9 @@ module GetStream
         # @!attribute feeds
         #   @return [Array<String>] List of feeds to add the activity to with a default max limit of 25 feeds
         attr_accessor :feeds
+        # @!attribute copy_custom_to_notification
+        #   @return [Boolean] Whether to copy custom data to the notification activity (only applies when create_notification_activity is true)
+        attr_accessor :copy_custom_to_notification
         # @!attribute create_notification_activity
         #   @return [Boolean] Whether to create notification activities for mentioned users
         attr_accessor :create_notification_activity
@@ -31,7 +34,7 @@ module GetStream
         #   @return [String] ID of a poll to attach to activity
         attr_accessor :poll_id
         # @!attribute restrict_replies
-        #   @return [String] Controls who can add comments/replies to this activity. Options: 'everyone' (default - anyone can reply), 'people_i_follow' (only people the activity creator follows can reply), 'nobody' (no one can reply)
+        #   @return [String] Controls who can add comments/replies to this activity. One of: everyone, people_i_follow, nobody
         attr_accessor :restrict_replies
         # @!attribute skip_enrich_url
         #   @return [Boolean] Whether to skip URL enrichment for the activity
@@ -46,7 +49,7 @@ module GetStream
         #   @return [String] ID of the user creating the activity
         attr_accessor :user_id
         # @!attribute visibility
-        #   @return [String] Visibility setting for the activity
+        #   @return [String] Visibility setting for the activity. One of: public, private, tag
         attr_accessor :visibility
         # @!attribute visibility_tag
         #   @return [String] If visibility is 'tag', this is the tag name and is required
@@ -81,6 +84,7 @@ module GetStream
           super(attributes)
           @type = attributes[:type] || attributes['type']
           @feeds = attributes[:feeds] || attributes['feeds']
+          @copy_custom_to_notification = attributes[:copy_custom_to_notification] || attributes['copy_custom_to_notification'] || nil
           @create_notification_activity = attributes[:create_notification_activity] || attributes['create_notification_activity'] || nil
           @expires_at = attributes[:expires_at] || attributes['expires_at'] || nil
           @id = attributes[:id] || attributes['id'] || nil
@@ -108,6 +112,7 @@ module GetStream
           {
             type: 'type',
             feeds: 'feeds',
+            copy_custom_to_notification: 'copy_custom_to_notification',
             create_notification_activity: 'create_notification_activity',
             expires_at: 'expires_at',
             id: 'id',

data/lib/getstream_ruby/generated/models/activity_response.rb

@@ -34,7 +34,7 @@ module GetStream
         #   @return [Integer] Number of reactions to the activity
         attr_accessor :reaction_count
         # @!attribute restrict_replies
-        #   @return [String] Controls who can reply to this activity. Values: everyone, people_i_follow, nobody
+        #   @return [String] Controls who can add comments/replies to this activity. One of: everyone, people_i_follow, nobody
         attr_accessor :restrict_replies
         # @!attribute score
         #   @return [Float] Ranking score for this activity
@@ -49,7 +49,7 @@ module GetStream
         #   @return [DateTime] When the activity was last updated
         attr_accessor :updated_at
         # @!attribute visibility
-        #   @return [String] Visibility setting for the activity
+        #   @return [String] Visibility setting for the activity. One of: public, private, tag
         attr_accessor :visibility
         # @!attribute attachments
         #   @return [Array<Attachment>] Media attachments for the activity
@@ -85,7 +85,7 @@ module GetStream
         #   @return [Object] Custom data for the activity
         attr_accessor :custom
         # @!attribute reaction_groups
-        #   @return [Hash<String, ReactionGroupResponse>] Grouped reactions by type
+        #   @return [Hash<String, FeedsReactionGroupResponse>] Grouped reactions by type
         attr_accessor :reaction_groups
         # @!attribute search_data
         #   @return [Object] Data for search indexing
@@ -102,6 +102,15 @@ module GetStream
         # @!attribute expires_at
         #   @return [DateTime] When the activity will expire
         attr_accessor :expires_at
+        # @!attribute friend_reaction_count
+        #   @return [Integer] Total count of reactions from friends on this activity
+        attr_accessor :friend_reaction_count
+        # @!attribute is_read
+        #   @return [Boolean] Whether this activity has been read. Only set for feed groups with notification config (track_seen/track_read enabled).
+        attr_accessor :is_read
+        # @!attribute is_seen
+        #   @return [Boolean] Whether this activity has been seen. Only set for feed groups with notification config (track_seen/track_read enabled).
+        attr_accessor :is_seen
         # @!attribute is_watched
         #   @return [Boolean]
         attr_accessor :is_watched
@@ -117,12 +126,18 @@ module GetStream
         # @!attribute visibility_tag
         #   @return [String] If visibility is 'tag', this is the tag name
         attr_accessor :visibility_tag
+        # @!attribute friend_reactions
+        #   @return [Array<FeedsReactionResponse>] Reactions from users the current user follows or has mutual follows with
+        attr_accessor :friend_reactions
         # @!attribute current_feed
         #   @return [FeedResponse]
         attr_accessor :current_feed
         # @!attribute location
         #   @return [ActivityLocation]
         attr_accessor :location
+        # @!attribute metrics
+        #   @return [Hash<String, Integer>]
+        attr_accessor :metrics
         # @!attribute moderation
         #   @return [ModerationV2Response]
         attr_accessor :moderation
@@ -170,13 +185,18 @@ module GetStream
           @deleted_at = attributes[:deleted_at] || attributes['deleted_at'] || nil
           @edited_at = attributes[:edited_at] || attributes['edited_at'] || nil
           @expires_at = attributes[:expires_at] || attributes['expires_at'] || nil
+          @friend_reaction_count = attributes[:friend_reaction_count] || attributes['friend_reaction_count'] || nil
+          @is_read = attributes[:is_read] || attributes['is_read'] || nil
+          @is_seen = attributes[:is_seen] || attributes['is_seen'] || nil
           @is_watched = attributes[:is_watched] || attributes['is_watched'] || nil
           @moderation_action = attributes[:moderation_action] || attributes['moderation_action'] || nil
           @selector_source = attributes[:selector_source] || attributes['selector_source'] || nil
           @text = attributes[:text] || attributes['text'] || nil
           @visibility_tag = attributes[:visibility_tag] || attributes['visibility_tag'] || nil
+          @friend_reactions = attributes[:friend_reactions] || attributes['friend_reactions'] || nil
           @current_feed = attributes[:current_feed] || attributes['current_feed'] || nil
           @location = attributes[:location] || attributes['location'] || nil
+          @metrics = attributes[:metrics] || attributes['metrics'] || nil
           @moderation = attributes[:moderation] || attributes['moderation'] || nil
           @notification_context = attributes[:notification_context] || attributes['notification_context'] || nil
           @parent = attributes[:parent] || attributes['parent'] || nil
@@ -217,13 +237,18 @@ module GetStream
             deleted_at: 'deleted_at',
             edited_at: 'edited_at',
             expires_at: 'expires_at',
+            friend_reaction_count: 'friend_reaction_count',
+            is_read: 'is_read',
+            is_seen: 'is_seen',
             is_watched: 'is_watched',
             moderation_action: 'moderation_action',
             selector_source: 'selector_source',
             text: 'text',
             visibility_tag: 'visibility_tag',
+            friend_reactions: 'friend_reactions',
             current_feed: 'current_feed',
             location: 'location',
+            metrics: 'metrics',
             moderation: 'moderation',
             notification_context: 'notification_context',
             parent: 'parent',

data/lib/getstream_ruby/generated/models/activity_restored_event.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# Code generated by GetStream internal OpenAPI code generator. DO NOT EDIT.
+
+module GetStream
+  module Generated
+    module Models
+      # Emitted when an activity is restored.
+      class ActivityRestoredEvent < GetStream::BaseModel
+
+        # Model attributes
+        # @!attribute created_at
+        #   @return [DateTime] Date/time of creation
+        attr_accessor :created_at
+        # @!attribute fid
+        #   @return [String]
+        attr_accessor :fid
+        # @!attribute activity
+        #   @return [ActivityResponse]
+        attr_accessor :activity
+        # @!attribute custom
+        #   @return [Object]
+        attr_accessor :custom
+        # @!attribute type
+        #   @return [String] The type of the event
+        attr_accessor :type
+        # @!attribute feed_visibility
+        #   @return [String]
+        attr_accessor :feed_visibility
+        # @!attribute received_at
+        #   @return [DateTime]
+        attr_accessor :received_at
+        # @!attribute user
+        #   @return [UserResponseCommonFields]
+        attr_accessor :user
+
+        # Initialize with attributes
+        def initialize(attributes = {})
+          super(attributes)
+          @created_at = attributes[:created_at] || attributes['created_at']
+          @fid = attributes[:fid] || attributes['fid']
+          @activity = attributes[:activity] || attributes['activity']
+          @custom = attributes[:custom] || attributes['custom']
+          @type = attributes[:type] || attributes['type'] || "feeds.activity.restored"
+          @feed_visibility = attributes[:feed_visibility] || attributes['feed_visibility'] || nil
+          @received_at = attributes[:received_at] || attributes['received_at'] || nil
+          @user = attributes[:user] || attributes['user'] || nil
+        end
+
+        # Override field mappings for JSON serialization
+        def self.json_field_mappings
+          {
+            created_at: 'created_at',
+            fid: 'fid',
+            activity: 'activity',
+            custom: 'custom',
+            type: 'type',
+            feed_visibility: 'feed_visibility',
+            received_at: 'received_at',
+            user: 'user'
+          }
+        end
+      end
+    end
+  end
+end

data/lib/getstream_ruby/generated/models/activity_selector_config.rb

@@ -10,7 +10,7 @@ module GetStream
 
         # Model attributes
         # @!attribute type
-        #   @return [String] Type of selector
+        #   @return [String] Type of selector. One of: popular, proximity, following, current_feed, query, interest, follow_suggestion
         attr_accessor :type
         # @!attribute cutoff_time
         #   @return [String] Time threshold for activity selection (string). Expected RFC3339 format (e.g., 2006-01-02T15:04:05Z07:00). Cannot be used together with cutoff_window