moderation_api 2.20.0 → 2.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb51c2dd8cbf252b7777f03017d7d3b4b3afc2a204113f917a40704e8789b5e3
-  data.tar.gz: 67a4613735a19a3c93b42a75f74d5468c29760ee6902e2147d56878d94d79008
+  metadata.gz: 547864fb63b08b0a2b9f6a917a87c37987466412e68df8d2d590d79443960126
+  data.tar.gz: 171fd0eab7ed0d611f8ae8568e4f1901393c890eb41246f70aa882363d960c1d
 SHA512:
-  metadata.gz: 6e0af9a126dcf53dd8d3a33a8a1f7f22c3ec1bbde86b735404d7954c9ff07a799b721b5785212c01d1403eb8f861b2786d52d5bf6e352e555aa2f29fefb114c7
-  data.tar.gz: bb6320deed400febf5e17485a176a0e3acf0ac0d3a4715e664de2a7215d5c5d74294c26dc4d47987982db6a3ebbfe980acb0ef30bec2cdb77c1364d3a67b16ef
+  metadata.gz: f4b4033ca81af4592e37b7b42d22058dbc7f2599c5e7824c34846f3196b69aac3e211555826c98d27a6c33d2bbe233ae0ef94918936313e50b56a3e084ffb1af
+  data.tar.gz: dd338f50d8e682d74d2010aa7a4727dd6e1ae1458c7399f921b7ad08ccc39545ccf53959e1d473d60a85dfd401590285cb725027d140a58cbdddd61f3485bb5a

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.21.0 (2026-06-02)
+
+Full Changelog: [v2.20.0...v2.21.0](https://github.com/moderation-api/sdk-ruby/compare/v2.20.0...v2.21.0)
+
+### Features
+
+* **api:** api update ([250e1b4](https://github.com/moderation-api/sdk-ruby/commit/250e1b4849fff5f9dfe39c267b4641c23fc46358))
+
 ## 2.20.0 (2026-06-01)
 
 Full Changelog: [v2.19.0...v2.20.0](https://github.com/moderation-api/sdk-ruby/compare/v2.19.0...v2.20.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "moderation_api", "~> 2.20.0"
+gem "moderation_api", "~> 2.21.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/moderation_api/models/content_submit_params.rb

@@ -26,6 +26,18 @@ module ModerationAPI
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute client_action
+      #   A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+      #   third-party tool). Feeds the rules engine and can escalate or override the
+      #   recommended action. Does not change whether our analysis flagged the content.
+      #
+      #   @return [ModerationAPI::Models::ContentSubmitParams::ClientAction, nil]
+      optional :client_action,
+               -> {
+                 ModerationAPI::ContentSubmitParams::ClientAction
+               },
+               api_name: :clientAction
+
       # @!attribute content_id
       #   The unique ID of the content in your database.
       #
@@ -70,7 +82,7 @@ module ModerationAPI
       #   @return [Float, nil]
       optional :timestamp, Float
 
-      # @!method initialize(content:, author_id: nil, channel: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
+      # @!method initialize(content:, author_id: nil, channel: nil, client_action: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ModerationAPI::Models::ContentSubmitParams} for more details.
       #
@@ -80,6 +92,8 @@ module ModerationAPI
       #
       #   @param channel [String] Provide a channel ID or key. Will use the project's default channel if not provi
       #
+      #   @param client_action [ModerationAPI::Models::ContentSubmitParams::ClientAction] A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+      #
       #   @param content_id [String] The unique ID of the content in your database.
       #
       #   @param conversation_id [String] For example the ID of a chat room or a post
@@ -345,6 +359,77 @@ module ModerationAPI
         #   @return [Array(ModerationAPI::Models::ContentSubmitParams::Content::Text, ModerationAPI::Models::ContentSubmitParams::Content::Image, ModerationAPI::Models::ContentSubmitParams::Content::Video, ModerationAPI::Models::ContentSubmitParams::Content::Audio, ModerationAPI::Models::ContentSubmitParams::Content::Object)]
       end
 
+      class ClientAction < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute action
+        #   Your recommendation for the content: allow, review, or reject.
+        #
+        #   @return [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Action]
+        required :action, enum: -> { ModerationAPI::ContentSubmitParams::ClientAction::Action }
+
+        # @!attribute behavior
+        #   How your recommendation combines with ours. Defaults to 'escalate', which only
+        #   applies it when stricter than ours; 'override' replaces ours outright.
+        #
+        #   @return [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Behavior, nil]
+        optional :behavior, enum: -> { ModerationAPI::ContentSubmitParams::ClientAction::Behavior }
+
+        # @!attribute reason
+        #   A human-readable explanation for your recommendation.
+        #
+        #   @return [String, nil]
+        optional :reason, String
+
+        # @!attribute source
+        #   Where your recommendation came from, e.g. "banned-ip".
+        #
+        #   @return [String, nil]
+        optional :source, String
+
+        # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ModerationAPI::Models::ContentSubmitParams::ClientAction} for more details.
+        #
+        #   A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+        #   third-party tool). Feeds the rules engine and can escalate or override the
+        #   recommended action. Does not change whether our analysis flagged the content.
+        #
+        #   @param action [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+        #
+        #   @param behavior [Symbol, ModerationAPI::Models::ContentSubmitParams::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+        #
+        #   @param reason [String] A human-readable explanation for your recommendation.
+        #
+        #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+        # Your recommendation for the content: allow, review, or reject.
+        #
+        # @see ModerationAPI::Models::ContentSubmitParams::ClientAction#action
+        module Action
+          extend ModerationAPI::Internal::Type::Enum
+
+          REVIEW = :review
+          ALLOW = :allow
+          REJECT = :reject
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How your recommendation combines with ours. Defaults to 'escalate', which only
+        # applies it when stricter than ours; 'override' replaces ours outright.
+        #
+        # @see ModerationAPI::Models::ContentSubmitParams::ClientAction#behavior
+        module Behavior
+          extend ModerationAPI::Internal::Type::Enum
+
+          OVERRIDE = :override
+          ESCALATE = :escalate
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # The meta type of content being moderated
       module MetaType
         extend ModerationAPI::Internal::Type::Enum

data/lib/moderation_api/models/content_submit_response.rb

@@ -907,6 +907,7 @@ module ModerationAPI
           RULE_MATCH = :rule_match
           RULE_DEFAULT = :rule_default
           RULE_FALLBACK = :rule_fallback
+          CLIENT_OVERRIDE = :client_override
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/moderation_api/models/webhook_event.rb

@@ -2435,6 +2435,16 @@ module ModerationAPI
               #   @return [String, nil]
               required :channel_key, String, nil?: true
 
+              # @!attribute client_action
+              #   A recommendation from your own client-side flagging.
+              #
+              #   @return [ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction, nil]
+              required :client_action,
+                       -> {
+                         ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction
+                       },
+                       nil?: true
+
               # @!attribute content
               #   The original content payload
               #
@@ -2496,7 +2506,7 @@ module ModerationAPI
               #   @return [Time]
               required :timestamp, Time
 
-              # @!method initialize(id:, author_id:, channel_key:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
+              # @!method initialize(id:, author_id:, channel_key:, client_action:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item} for
               #   more details.
@@ -2507,6 +2517,8 @@ module ModerationAPI
               #
               #   @param channel_key [String, nil] The channel the content was submitted to, identified by your customer-defined ch
               #
+              #   @param client_action [ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction, nil] A recommendation from your own client-side flagging.
+              #
               #   @param content [ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Text, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Image, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Video, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Audio, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Object] The original content payload
               #
               #   @param conversation_id [String, nil] Conversation grouping ID, if any
@@ -2523,6 +2535,79 @@ module ModerationAPI
               #
               #   @param timestamp [Time] ISO 8601 timestamp of when the content was submitted
 
+              # @see ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item#client_action
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                # @!attribute action
+                #   Your recommendation for the content: allow, review, or reject.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action]
+                required :action,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action }
+
+                # @!attribute behavior
+                #   How your recommendation combines with ours. Defaults to 'escalate', which only
+                #   applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior, nil]
+                optional :behavior,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior }
+
+                # @!attribute reason
+                #   A human-readable explanation for your recommendation.
+                #
+                #   @return [String, nil]
+                optional :reason, String
+
+                # @!attribute source
+                #   Where your recommendation came from, e.g. "banned-ip".
+                #
+                #   @return [String, nil]
+                optional :source, String
+
+                # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction}
+                #   for more details.
+                #
+                #   A recommendation from your own client-side flagging.
+                #
+                #   @param action [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+                #
+                #   @param behavior [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+                #
+                #   @param reason [String] A human-readable explanation for your recommendation.
+                #
+                #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+                # Your recommendation for the content: allow, review, or reject.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction#action
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW = :review
+                  ALLOW = :allow
+                  REJECT = :reject
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction#behavior
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE = :override
+                  ESCALATE = :escalate
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
               # The original content payload
               #
               # @see ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item#content
@@ -3699,6 +3784,14 @@ module ModerationAPI
               #   @return [String, nil]
               required :channel_key, String, nil?: true
 
+              # @!attribute client_action
+              #   A recommendation from your own client-side flagging.
+              #
+              #   @return [ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction, nil]
+              required :client_action,
+                       -> { ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction },
+                       nil?: true
+
               # @!attribute content
               #   The original content payload
               #
@@ -3759,7 +3852,7 @@ module ModerationAPI
               #   @return [Time]
               required :timestamp, Time
 
-              # @!method initialize(id:, author_id:, channel_key:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
+              # @!method initialize(id:, author_id:, channel_key:, client_action:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item} for
               #   more details.
@@ -3772,6 +3865,8 @@ module ModerationAPI
               #
               #   @param channel_key [String, nil] The channel the content was submitted to, identified by your customer-defined ch
               #
+              #   @param client_action [ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction, nil] A recommendation from your own client-side flagging.
+              #
               #   @param content [ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Text, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Image, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Video, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Audio, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Object] The original content payload
               #
               #   @param conversation_id [String, nil] Conversation grouping ID, if any
@@ -3788,6 +3883,79 @@ module ModerationAPI
               #
               #   @param timestamp [Time] ISO 8601 timestamp of when the content was submitted
 
+              # @see ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item#client_action
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                # @!attribute action
+                #   Your recommendation for the content: allow, review, or reject.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action]
+                required :action,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action }
+
+                # @!attribute behavior
+                #   How your recommendation combines with ours. Defaults to 'escalate', which only
+                #   applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior, nil]
+                optional :behavior,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior }
+
+                # @!attribute reason
+                #   A human-readable explanation for your recommendation.
+                #
+                #   @return [String, nil]
+                optional :reason, String
+
+                # @!attribute source
+                #   Where your recommendation came from, e.g. "banned-ip".
+                #
+                #   @return [String, nil]
+                optional :source, String
+
+                # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction}
+                #   for more details.
+                #
+                #   A recommendation from your own client-side flagging.
+                #
+                #   @param action [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+                #
+                #   @param behavior [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+                #
+                #   @param reason [String] A human-readable explanation for your recommendation.
+                #
+                #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+                # Your recommendation for the content: allow, review, or reject.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction#action
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW = :review
+                  ALLOW = :allow
+                  REJECT = :reject
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction#behavior
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE = :override
+                  ESCALATE = :escalate
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
               # The original content payload
               #
               # @see ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item#content
@@ -4682,6 +4850,16 @@ module ModerationAPI
               #   @return [String, nil]
               required :channel_key, String, nil?: true
 
+              # @!attribute client_action
+              #   A recommendation from your own client-side flagging.
+              #
+              #   @return [ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction, nil]
+              required :client_action,
+                       -> {
+                         ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction
+                       },
+                       nil?: true
+
               # @!attribute content
               #   The original content payload
               #
@@ -4743,7 +4921,7 @@ module ModerationAPI
               #   @return [Time]
               required :timestamp, Time
 
-              # @!method initialize(id:, author_id:, channel_key:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
+              # @!method initialize(id:, author_id:, channel_key:, client_action:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item} for
               #   more details.
@@ -4756,6 +4934,8 @@ module ModerationAPI
               #
               #   @param channel_key [String, nil] The channel the content was submitted to, identified by your customer-defined ch
               #
+              #   @param client_action [ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction, nil] A recommendation from your own client-side flagging.
+              #
               #   @param content [ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Text, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Image, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Video, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Audio, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Object] The original content payload
               #
               #   @param conversation_id [String, nil] Conversation grouping ID, if any
@@ -4772,6 +4952,79 @@ module ModerationAPI
               #
               #   @param timestamp [Time] ISO 8601 timestamp of when the content was submitted
 
+              # @see ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item#client_action
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                # @!attribute action
+                #   Your recommendation for the content: allow, review, or reject.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action]
+                required :action,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action }
+
+                # @!attribute behavior
+                #   How your recommendation combines with ours. Defaults to 'escalate', which only
+                #   applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior, nil]
+                optional :behavior,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior }
+
+                # @!attribute reason
+                #   A human-readable explanation for your recommendation.
+                #
+                #   @return [String, nil]
+                optional :reason, String
+
+                # @!attribute source
+                #   Where your recommendation came from, e.g. "banned-ip".
+                #
+                #   @return [String, nil]
+                optional :source, String
+
+                # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction}
+                #   for more details.
+                #
+                #   A recommendation from your own client-side flagging.
+                #
+                #   @param action [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+                #
+                #   @param behavior [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+                #
+                #   @param reason [String] A human-readable explanation for your recommendation.
+                #
+                #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+                # Your recommendation for the content: allow, review, or reject.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction#action
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW = :review
+                  ALLOW = :allow
+                  REJECT = :reject
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction#behavior
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE = :override
+                  ESCALATE = :escalate
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
               # The original content payload
               #
               # @see ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item#content
@@ -5665,6 +5918,14 @@ module ModerationAPI
               #   @return [String, nil]
               required :channel_key, String, nil?: true
 
+              # @!attribute client_action
+              #   A recommendation from your own client-side flagging.
+              #
+              #   @return [ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction, nil]
+              required :client_action,
+                       -> { ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction },
+                       nil?: true
+
               # @!attribute content
               #   The original content payload
               #
@@ -5726,7 +5987,7 @@ module ModerationAPI
               #   @return [Time]
               required :timestamp, Time
 
-              # @!method initialize(id:, author_id:, channel_key:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
+              # @!method initialize(id:, author_id:, channel_key:, client_action:, content:, conversation_id:, flagged:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item} for
               #   more details.
@@ -5739,6 +6000,8 @@ module ModerationAPI
               #
               #   @param channel_key [String, nil] The channel the content was submitted to, identified by your customer-defined ch
               #
+              #   @param client_action [ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction, nil] A recommendation from your own client-side flagging.
+              #
               #   @param content [ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Text, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Image, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Video, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Audio, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Object] The original content payload
               #
               #   @param conversation_id [String, nil] Conversation grouping ID, if any
@@ -5755,6 +6018,79 @@ module ModerationAPI
               #
               #   @param timestamp [Time] ISO 8601 timestamp of when the content was submitted
 
+              # @see ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item#client_action
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                # @!attribute action
+                #   Your recommendation for the content: allow, review, or reject.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action]
+                required :action,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action }
+
+                # @!attribute behavior
+                #   How your recommendation combines with ours. Defaults to 'escalate', which only
+                #   applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                #   @return [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior, nil]
+                optional :behavior,
+                         enum: -> { ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior }
+
+                # @!attribute reason
+                #   A human-readable explanation for your recommendation.
+                #
+                #   @return [String, nil]
+                optional :reason, String
+
+                # @!attribute source
+                #   Where your recommendation came from, e.g. "banned-ip".
+                #
+                #   @return [String, nil]
+                optional :source, String
+
+                # @!method initialize(action:, behavior: nil, reason: nil, source: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction}
+                #   for more details.
+                #
+                #   A recommendation from your own client-side flagging.
+                #
+                #   @param action [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action] Your recommendation for the content: allow, review, or reject.
+                #
+                #   @param behavior [Symbol, ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior] How your recommendation combines with ours. Defaults to 'escalate', which only a
+                #
+                #   @param reason [String] A human-readable explanation for your recommendation.
+                #
+                #   @param source [String] Where your recommendation came from, e.g. "banned-ip".
+
+                # Your recommendation for the content: allow, review, or reject.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction#action
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW = :review
+                  ALLOW = :allow
+                  REJECT = :reject
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                #
+                # @see ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction#behavior
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE = :override
+                  ESCALATE = :escalate
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+              end
+
               # The original content payload
               #
               # @see ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item#content

data/lib/moderation_api/resources/content.rb

@@ -6,7 +6,7 @@ module ModerationAPI
       # Some parameter documentations has been truncated, see
       # {ModerationAPI::Models::ContentSubmitParams} for more details.
       #
-      # @overload submit(content:, author_id: nil, channel: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
+      # @overload submit(content:, author_id: nil, channel: nil, client_action: nil, content_id: nil, conversation_id: nil, do_not_store: nil, metadata: nil, meta_type: nil, policies: nil, timestamp: nil, request_options: {})
       #
       # @param content [ModerationAPI::Models::ContentSubmitParams::Content::Text, ModerationAPI::Models::ContentSubmitParams::Content::Image, ModerationAPI::Models::ContentSubmitParams::Content::Video, ModerationAPI::Models::ContentSubmitParams::Content::Audio, ModerationAPI::Models::ContentSubmitParams::Content::Object] The content sent for moderation
       #
@@ -14,6 +14,8 @@ module ModerationAPI
       #
       # @param channel [String] Provide a channel ID or key. Will use the project's default channel if not provi
       #
+      # @param client_action [ModerationAPI::Models::ContentSubmitParams::ClientAction] A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+      #
       # @param content_id [String] The unique ID of the content in your database.
       #
       # @param conversation_id [String] For example the ID of a chat room or a post

data/lib/moderation_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModerationAPI
-  VERSION = "2.20.0"
+  VERSION = "2.21.0"
 end