knockapi 1.8.0 → 1.9.0

data/rbi/knockapi/models/page_info.rbi

@@ -10,7 +10,7 @@ module Knockapi
       sig { returns(String) }
       attr_accessor :_typename
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(Integer) }
       attr_accessor :page_size
 
@@ -34,7 +34,7 @@ module Knockapi
       def self.new(
         # The typename of the schema.
         _typename:,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size:,
         # The cursor to fetch entries after.
         after: nil,

data/rbi/knockapi/models/recipients/ms_teams_channel_data.rbi

@@ -29,7 +29,7 @@ module Knockapi
         sig { returns(T.nilable(String)) }
         attr_accessor :ms_teams_tenant_id
 
-        # Microsoft Teams channel connection.
+        # Microsoft Teams channel data.
         sig do
           params(
             connections:

data/rbi/knockapi/models/recipients/push_channel_data.rbi

@@ -16,7 +16,7 @@ module Knockapi
         sig { returns(T::Array[String]) }
         attr_accessor :tokens
 
-        # The content of a push notification.
+        # Push channel data.
         sig { params(tokens: T::Array[String]).returns(T.attached_class) }
         def self.new(
           # A list of push channel tokens.

data/rbi/knockapi/models/recipients/slack_channel_data.rbi

@@ -39,7 +39,7 @@ module Knockapi
         end
         attr_writer :token
 
-        # Slack channel data
+        # Slack channel data.
         sig do
           params(
             connections:

data/rbi/knockapi/models/schedule_list_params.rbi

@@ -29,7 +29,7 @@ module Knockapi
       sig { params(before: String).void }
       attr_writer :before
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -92,7 +92,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Filter by recipient references.
         recipients: nil,

data/rbi/knockapi/models/tenant_list_params.rbi

@@ -32,7 +32,7 @@ module Knockapi
       sig { params(name: String).void }
       attr_writer :name
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -63,7 +63,7 @@ module Knockapi
         before: nil,
         # Filter tenants by name.
         name: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Filter tenants by ID.
         tenant_id: nil,

data/rbi/knockapi/models/user.rbi

@@ -6,7 +6,7 @@ module Knockapi
       OrHash =
         T.type_alias { T.any(Knockapi::User, Knockapi::Internal::AnyHash) }
 
-      # The ID for the user that you set when identifying them in Knock.
+      # The unique identifier of the user.
       sig { returns(String) }
       attr_accessor :id
 
@@ -18,7 +18,7 @@ module Knockapi
       sig { returns(Time) }
       attr_accessor :updated_at
 
-      # URL to the user's avatar image.
+      # A URL for the avatar of the user.
       sig { returns(T.nilable(String)) }
       attr_accessor :avatar
 
@@ -63,13 +63,13 @@ module Knockapi
         ).returns(T.attached_class)
       end
       def self.new(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         id:,
         # The typename of the schema.
         _typename:,
         # The timestamp when the resource was last updated.
         updated_at:,
-        # URL to the user's avatar image.
+        # A URL for the avatar of the user.
         avatar: nil,
         # The creation date of the user from your system.
         created_at: nil,

data/rbi/knockapi/models/user_list_messages_params.rbi

@@ -72,7 +72,7 @@ module Knockapi
       sig { params(message_ids: T::Array[String]).void }
       attr_writer :message_ids
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -176,7 +176,7 @@ module Knockapi
         # Limits the results to only the message IDs given (max 50). Note: when using this
         # option, the results will be subject to any other filters applied to the query.
         message_ids: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Limits the results to messages triggered by the given workflow key.
         source: nil,

data/rbi/knockapi/models/user_list_params.rbi

@@ -40,7 +40,7 @@ module Knockapi
       end
       attr_writer :include
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -63,7 +63,7 @@ module Knockapi
         before: nil,
         # Associated resources to include in the response.
         include: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )

data/rbi/knockapi/models/user_list_schedules_params.rbi

@@ -25,7 +25,7 @@ module Knockapi
       sig { params(before: String).void }
       attr_writer :before
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -61,7 +61,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # The tenant ID to filter schedules for.
         tenant: nil,

data/rbi/knockapi/models/user_list_subscriptions_params.rbi

@@ -71,7 +71,7 @@ module Knockapi
       end
       attr_writer :objects
 
-      # The number of items per page.
+      # The number of items per page (defaults to 50).
       sig { returns(T.nilable(Integer)) }
       attr_reader :page_size
 
@@ -104,7 +104,7 @@ module Knockapi
         include: nil,
         # Only returns subscriptions for the specified object references.
         objects: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )

data/rbi/knockapi/models/users/feed_list_items_params.rbi

@@ -51,14 +51,14 @@ module Knockapi
         sig { params(has_tenant: T::Boolean).void }
         attr_writer :has_tenant
 
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
 
         sig { params(page_size: Integer).void }
         attr_writer :page_size
 
-        # The source of the feed items.
+        # The workflow key associated with the message in the feed.
         sig { returns(T.nilable(String)) }
         attr_reader :source
 
@@ -125,9 +125,9 @@ module Knockapi
           before: nil,
           # Whether the feed items have a tenant.
           has_tenant: nil,
-          # The number of items per page.
+          # The number of items per page (defaults to 50).
           page_size: nil,
-          # The source of the feed items.
+          # The workflow key associated with the message in the feed.
           source: nil,
           # The status of the feed items.
           status: nil,

data/rbi/knockapi/resources/messages.rbi

@@ -40,7 +40,7 @@ module Knockapi
         # Limits the results to only the message IDs given (max 50). Note: when using this
         # option, the results will be subject to any other filters applied to the query.
         message_ids: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Limits the results to messages triggered by the given workflow key.
         source: nil,
@@ -125,7 +125,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # The trigger data to filter activities by.
         trigger_data: nil,
@@ -150,7 +150,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )
@@ -173,7 +173,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )

data/rbi/knockapi/resources/objects.rbi

@@ -27,7 +27,7 @@ module Knockapi
         before: nil,
         # Includes preferences of the objects in the response.
         include: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )
@@ -216,7 +216,7 @@ module Knockapi
         # Limits the results to only the message IDs given (max 50). Note: when using this
         # option, the results will be subject to any other filters applied to the query.
         message_ids: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Limits the results to messages triggered by the given workflow key.
         source: nil,
@@ -278,7 +278,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Filter schedules by tenant id.
         tenant: nil,
@@ -334,7 +334,7 @@ module Knockapi
         mode: nil,
         # Objects to filter by (only used if mode is `recipient`).
         objects: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Recipients to filter by (only used if mode is `object`).
         recipients: nil,

data/rbi/knockapi/resources/schedules.rbi

@@ -136,7 +136,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Filter by recipient references.
         recipients: nil,

data/rbi/knockapi/resources/tenants.rbi

@@ -24,7 +24,7 @@ module Knockapi
         before: nil,
         # Filter tenants by name.
         name: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Filter tenants by ID.
         tenant_id: nil,

data/rbi/knockapi/resources/users/feeds.rbi

@@ -13,7 +13,7 @@ module Knockapi
           ).returns(Knockapi::Models::Users::FeedGetSettingsResponse)
         end
         def get_settings(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the channel.
           id,
@@ -21,8 +21,20 @@ module Knockapi
         )
         end
 
-        # Returns a paginated list of feed items for a user, including metadata about the
-        # feed.
+        # Returns a paginated list of feed items for a user in reverse chronological
+        # order, including metadata about the feed. If the user has not yet been
+        # identified within Knock, an empty feed will be returned.
+        #
+        # You can customize the response using
+        # [response filters](/integrations/in-app/knock#customizing-api-response-content)
+        # to exclude or only include specific properties on your resources.
+        #
+        # **Notes:**
+        #
+        # - When making this call from a client-side environment, use your publishable key
+        #   along with a user token.
+        # - This endpoint’s rate limit is always scoped per-user and per-environment. This
+        #   is true even for requests made without a signed user token.
         sig do
           params(
             user_id: String,
@@ -45,7 +57,7 @@ module Knockapi
           )
         end
         def list_items(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the channel.
           id,
@@ -57,9 +69,9 @@ module Knockapi
           before: nil,
           # Whether the feed items have a tenant.
           has_tenant: nil,
-          # The number of items per page.
+          # The number of items per page (defaults to 50).
           page_size: nil,
-          # The source of the feed items.
+          # The workflow key associated with the message in the feed.
           source: nil,
           # The status of the feed items.
           status: nil,

data/rbi/knockapi/resources/users/guides.rbi

@@ -16,7 +16,7 @@ module Knockapi
           ).returns(Knockapi::Models::Users::GuideGetChannelResponse)
         end
         def get_channel(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the channel.
           channel_id,
@@ -49,7 +49,7 @@ module Knockapi
           ).returns(Knockapi::Models::Users::GuideMarkMessageAsArchivedResponse)
         end
         def mark_message_as_archived(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the message.
           message_id,
@@ -96,7 +96,7 @@ module Knockapi
           )
         end
         def mark_message_as_interacted(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the message.
           message_id,
@@ -141,7 +141,7 @@ module Knockapi
           ).returns(Knockapi::Models::Users::GuideMarkMessageAsSeenResponse)
         end
         def mark_message_as_seen(
-          # The ID for the user that you set when identifying them in Knock.
+          # The unique identifier of the user.
           user_id,
           # The unique identifier for the message.
           message_id,

data/rbi/knockapi/resources/users.rbi

@@ -49,9 +49,9 @@ module Knockapi
         ).returns(Knockapi::User)
       end
       def update(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
-        # URL to the user's avatar image.
+        # A URL for the avatar of the user.
         avatar: nil,
         # A request to set channel data for a type of channel inline.
         channel_data: nil,
@@ -97,7 +97,7 @@ module Knockapi
         before: nil,
         # Associated resources to include in the response.
         include: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )
@@ -140,7 +140,7 @@ module Knockapi
         ).returns(Knockapi::Recipients::RecipientsChannelData)
       end
       def get_channel_data(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         # The unique identifier for the channel.
         channel_id,
@@ -159,7 +159,7 @@ module Knockapi
         ).returns(Knockapi::Recipients::PreferenceSet)
       end
       def get_preferences(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         # Unique identifier for the preference set.
         id,
@@ -169,9 +169,9 @@ module Knockapi
       )
       end
 
-      # Returns a paginated list of messages for a specific user. Allows filtering by
-      # message status and provides various sorting options. Messages outside the
-      # account's retention window will not be included in the results.
+      # Returns a paginated list of messages for a specific user. Messages are sorted
+      # with the most recent ones appearing first. Messages outside the account's
+      # retention window will not be included in the results.
       sig do
         params(
           user_id: String,
@@ -210,7 +210,7 @@ module Knockapi
         # Limits the results to only the message IDs given (max 50). Note: when using this
         # option, the results will be subject to any other filters applied to the query.
         message_ids: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # Limits the results to messages triggered by the given workflow key.
         source: nil,
@@ -241,7 +241,7 @@ module Knockapi
         ).returns(T::Array[Knockapi::Recipients::PreferenceSet])
       end
       def list_preferences(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         request_options: {}
       )
@@ -266,7 +266,7 @@ module Knockapi
         after: nil,
         # The cursor to fetch entries before.
         before: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         # The tenant ID to filter schedules for.
         tenant: nil,
@@ -309,7 +309,7 @@ module Knockapi
         include: nil,
         # Only returns subscriptions for the specified object references.
         objects: nil,
-        # The number of items per page.
+        # The number of items per page (defaults to 50).
         page_size: nil,
         request_options: {}
       )
@@ -352,7 +352,7 @@ module Knockapi
         ).returns(Knockapi::Recipients::RecipientsChannelData)
       end
       def set_channel_data(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         # The unique identifier for the channel.
         channel_id,
@@ -394,7 +394,7 @@ module Knockapi
         ).returns(Knockapi::Recipients::PreferenceSet)
       end
       def set_preferences(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         # Unique identifier for the preference set.
         id,
@@ -419,7 +419,7 @@ module Knockapi
         ).returns(String)
       end
       def unset_channel_data(
-        # The ID for the user that you set when identifying them in Knock.
+        # The unique identifier of the user.
         user_id,
         # The unique identifier for the channel.
         channel_id,

data/sig/knockapi/errors.rbs

@@ -5,6 +5,15 @@ module Knockapi
     end
 
     class ConversionError < Knockapi::Errors::Error
+      def cause: -> StandardError?
+
+      def initialize: (
+        on: Class,
+        method: Symbol,
+        target: top,
+        value: top,
+        ?cause: StandardError?
+      ) -> void
     end
 
     class APIError < Knockapi::Errors::Error

data/sig/knockapi/internal/type/converter.rbs

@@ -8,8 +8,10 @@ module Knockapi
 
         type coerce_state =
           {
-            strictness: bool | :strong,
+            translate_names: bool,
+            strictness: bool,
             exactness: { yes: Integer, no: Integer, maybe: Integer },
+            error: Class,
             branched: Integer
           }
 
@@ -37,6 +39,10 @@ module Knockapi
           | Knockapi::Internal::Type::Converter::input spec
         ) -> (^-> top)
 
+        def self.new_coerce_state: (
+          ?translate_names: bool
+        ) -> Knockapi::Internal::Type::Converter::coerce_state
+
         def self.coerce: (
           Knockapi::Internal::Type::Converter::input target,
           top value,

data/sig/knockapi/models/message.rbs

@@ -164,7 +164,8 @@ module Knockapi
           _typename: String,
           categories: ::Array[String],
           key: String,
-          version_id: String
+          version_id: String,
+          step_ref: String?
         }
 
       class Source < Knockapi::Internal::Type::BaseModel
@@ -176,18 +177,22 @@ module Knockapi
 
         attr_accessor version_id: String
 
+        attr_accessor step_ref: String?
+
         def initialize: (
           _typename: String,
           categories: ::Array[String],
           key: String,
-          version_id: String
+          version_id: String,
+          ?step_ref: String?
         ) -> void
 
         def to_hash: -> {
           _typename: String,
           categories: ::Array[String],
           key: String,
-          version_id: String
+          version_id: String,
+          step_ref: String?
         }
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: knockapi
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Knock
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-13 00:00:00.000000000 Z
+date: 2025-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool