moderation_api 2.19.0 → 2.21.0

data/rbi/moderation_api/resources/content.rbi

@@ -15,6 +15,8 @@ module ModerationAPI
             ),
           author_id: String,
           channel: String,
+          client_action:
+            ModerationAPI::ContentSubmitParams::ClientAction::OrHash,
           content_id: String,
           conversation_id: String,
           do_not_store: T::Boolean,
@@ -43,6 +45,7 @@ module ModerationAPI
                 ModerationAPI::ContentSubmitParams::Policy::SelfHarm::OrHash,
                 ModerationAPI::ContentSubmitParams::Policy::Spam::OrHash,
                 ModerationAPI::ContentSubmitParams::Policy::LowQualityContent::OrHash,
+                ModerationAPI::ContentSubmitParams::Policy::FaceDetection::OrHash,
                 ModerationAPI::ContentSubmitParams::Policy::SelfPromotion::OrHash,
                 ModerationAPI::ContentSubmitParams::Policy::Political::OrHash,
                 ModerationAPI::ContentSubmitParams::Policy::Religion::OrHash,
@@ -65,6 +68,10 @@ module ModerationAPI
         # Provide a channel ID or key. Will use the project's default channel if not
         # provided.
         channel: nil,
+        # 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.
+        client_action: nil,
         # The unique ID of the content in your database.
         content_id: nil,
         # For example the ID of a chat room or a post

data/sig/moderation_api/models/content_submit_params.rbs

@@ -5,6 +5,7 @@ module ModerationAPI
         content: ModerationAPI::Models::ContentSubmitParams::content,
         author_id: String,
         channel: String,
+        client_action: ModerationAPI::ContentSubmitParams::ClientAction,
         content_id: String,
         conversation_id: String,
         do_not_store: bool,
@@ -29,6 +30,12 @@ module ModerationAPI
 
       def channel=: (String) -> String
 
+      attr_reader client_action: ModerationAPI::ContentSubmitParams::ClientAction?
+
+      def client_action=: (
+        ModerationAPI::ContentSubmitParams::ClientAction
+      ) -> ModerationAPI::ContentSubmitParams::ClientAction
+
       attr_reader content_id: String?
 
       def content_id=: (String) -> String
@@ -65,6 +72,7 @@ module ModerationAPI
         content: ModerationAPI::Models::ContentSubmitParams::content,
         ?author_id: String,
         ?channel: String,
+        ?client_action: ModerationAPI::ContentSubmitParams::ClientAction,
         ?content_id: String,
         ?conversation_id: String,
         ?do_not_store: bool,
@@ -79,6 +87,7 @@ module ModerationAPI
         content: ModerationAPI::Models::ContentSubmitParams::content,
         author_id: String,
         channel: String,
+        client_action: ModerationAPI::ContentSubmitParams::ClientAction,
         content_id: String,
         conversation_id: String,
         do_not_store: bool,
@@ -248,6 +257,69 @@ module ModerationAPI
         def self?.variants: -> ::Array[ModerationAPI::Models::ContentSubmitParams::content]
       end
 
+      type client_action =
+        {
+          action: ModerationAPI::Models::ContentSubmitParams::ClientAction::action,
+          behavior: ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior,
+          reason: String,
+          source: String
+        }
+
+      class ClientAction < ModerationAPI::Internal::Type::BaseModel
+        attr_accessor action: ModerationAPI::Models::ContentSubmitParams::ClientAction::action
+
+        attr_reader behavior: ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior?
+
+        def behavior=: (
+          ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior
+        ) -> ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior
+
+        attr_reader reason: String?
+
+        def reason=: (String) -> String
+
+        attr_reader source: String?
+
+        def source=: (String) -> String
+
+        def initialize: (
+          action: ModerationAPI::Models::ContentSubmitParams::ClientAction::action,
+          ?behavior: ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior,
+          ?reason: String,
+          ?source: String
+        ) -> void
+
+        def to_hash: -> {
+          action: ModerationAPI::Models::ContentSubmitParams::ClientAction::action,
+          behavior: ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior,
+          reason: String,
+          source: String
+        }
+
+        type action = :review | :allow | :reject
+
+        module Action
+          extend ModerationAPI::Internal::Type::Enum
+
+          REVIEW: :review
+          ALLOW: :allow
+          REJECT: :reject
+
+          def self?.values: -> ::Array[ModerationAPI::Models::ContentSubmitParams::ClientAction::action]
+        end
+
+        type behavior = :override | :escalate
+
+        module Behavior
+          extend ModerationAPI::Internal::Type::Enum
+
+          OVERRIDE: :override
+          ESCALATE: :escalate
+
+          def self?.values: -> ::Array[ModerationAPI::Models::ContentSubmitParams::ClientAction::behavior]
+        end
+      end
+
       type meta_type =
         :profile
         | :message
@@ -294,6 +366,7 @@ module ModerationAPI
         | ModerationAPI::ContentSubmitParams::Policy::SelfHarm
         | ModerationAPI::ContentSubmitParams::Policy::Spam
         | ModerationAPI::ContentSubmitParams::Policy::LowQualityContent
+        | ModerationAPI::ContentSubmitParams::Policy::FaceDetection
         | ModerationAPI::ContentSubmitParams::Policy::SelfPromotion
         | ModerationAPI::ContentSubmitParams::Policy::Political
         | ModerationAPI::ContentSubmitParams::Policy::Religion
@@ -712,6 +785,62 @@ module ModerationAPI
           }
         end
 
+        type face_detection =
+          {
+            id: :face_detection,
+            flag: bool,
+            comparator: ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator,
+            count: Integer,
+            threshold: Float
+          }
+
+        class FaceDetection < ModerationAPI::Internal::Type::BaseModel
+          attr_accessor id: :face_detection
+
+          attr_accessor flag: bool
+
+          attr_reader comparator: ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator?
+
+          def comparator=: (
+            ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator
+          ) -> ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator
+
+          attr_reader count: Integer?
+
+          def count=: (Integer) -> Integer
+
+          attr_reader threshold: Float?
+
+          def threshold=: (Float) -> Float
+
+          def initialize: (
+            flag: bool,
+            ?comparator: ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator,
+            ?count: Integer,
+            ?threshold: Float,
+            ?id: :face_detection
+          ) -> void
+
+          def to_hash: -> {
+            id: :face_detection,
+            flag: bool,
+            comparator: ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator,
+            count: Integer,
+            threshold: Float
+          }
+
+          type comparator = :at_least | :fewer_than
+
+          module Comparator
+            extend ModerationAPI::Internal::Type::Enum
+
+            AT_LEAST: :at_least
+            FEWER_THAN: :fewer_than
+
+            def self?.values: -> ::Array[ModerationAPI::Models::ContentSubmitParams::Policy::FaceDetection::comparator]
+          end
+        end
+
         type self_promotion =
           { id: :self_promotion, flag: bool, threshold: Float }
 

data/sig/moderation_api/models/content_submit_response.rbs

@@ -430,6 +430,7 @@ module ModerationAPI
             flagged: bool,
             probability: Float,
             type: :classifier,
+            data: ::Hash[Symbol, top],
             flagged_fields: ::Array[String],
             labels: ::Array[ModerationAPI::Models::ContentSubmitResponse::Policy::ClassifierOutput::Label]
           }
@@ -443,6 +444,10 @@ module ModerationAPI
 
           attr_accessor type: :classifier
 
+          attr_reader data: ::Hash[Symbol, top]?
+
+          def data=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
           attr_reader flagged_fields: ::Array[String]?
 
           def flagged_fields=: (::Array[String]) -> ::Array[String]
@@ -457,6 +462,7 @@ module ModerationAPI
             id: String,
             flagged: bool,
             probability: Float,
+            ?data: ::Hash[Symbol, top],
             ?flagged_fields: ::Array[String],
             ?labels: ::Array[ModerationAPI::Models::ContentSubmitResponse::Policy::ClassifierOutput::Label],
             ?type: :classifier
@@ -467,6 +473,7 @@ module ModerationAPI
             flagged: bool,
             probability: Float,
             type: :classifier,
+            data: ::Hash[Symbol, top],
             flagged_fields: ::Array[String],
             labels: ::Array[ModerationAPI::Models::ContentSubmitResponse::Policy::ClassifierOutput::Label]
           }
@@ -729,6 +736,7 @@ module ModerationAPI
           | :rule_match
           | :rule_default
           | :rule_fallback
+          | :client_override
 
         module ReasonCode
           extend ModerationAPI::Internal::Type::Enum
@@ -742,6 +750,7 @@ module ModerationAPI
           RULE_MATCH: :rule_match
           RULE_DEFAULT: :rule_default
           RULE_FALLBACK: :rule_fallback
+          CLIENT_OVERRIDE: :client_override
 
           def self?.values: -> ::Array[ModerationAPI::Models::ContentSubmitResponse::Recommendation::reason_code]
         end

data/sig/moderation_api/models/webhook_event.rbs

@@ -1846,6 +1846,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -1863,6 +1864,8 @@ module ModerationAPI
 
               attr_accessor channel_key: String?
 
+              attr_accessor client_action: ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction?
+
               attr_accessor content: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::content
 
               attr_accessor conversation_id: String?
@@ -1883,6 +1886,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -1897,6 +1901,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -1907,6 +1912,69 @@ module ModerationAPI
                 timestamp: Time
               }
 
+              type client_action =
+                {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                attr_accessor action: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::action
+
+                attr_reader behavior: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior?
+
+                def behavior=: (
+                  ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior
+                ) -> ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior
+
+                attr_reader reason: String?
+
+                def reason=: (String) -> String
+
+                attr_reader source: String?
+
+                def source=: (String) -> String
+
+                def initialize: (
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::action,
+                  ?behavior: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior,
+                  ?reason: String,
+                  ?source: String
+                ) -> void
+
+                def to_hash: -> {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+                type action = :review | :allow | :reject
+
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW: :review
+                  ALLOW: :allow
+                  REJECT: :reject
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::action]
+                end
+
+                type behavior = :override | :escalate
+
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE: :override
+                  ESCALATE: :escalate
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::behavior]
+                end
+              end
+
               type content =
                 ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Text
                 | ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Image
@@ -2795,6 +2863,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -2812,6 +2881,8 @@ module ModerationAPI
 
               attr_accessor channel_key: String?
 
+              attr_accessor client_action: ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction?
+
               attr_accessor content: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::content
 
               attr_accessor conversation_id: String?
@@ -2832,6 +2903,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -2846,6 +2918,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -2856,6 +2929,69 @@ module ModerationAPI
                 timestamp: Time
               }
 
+              type client_action =
+                {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                attr_accessor action: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::action
+
+                attr_reader behavior: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior?
+
+                def behavior=: (
+                  ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior
+                ) -> ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior
+
+                attr_reader reason: String?
+
+                def reason=: (String) -> String
+
+                attr_reader source: String?
+
+                def source=: (String) -> String
+
+                def initialize: (
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::action,
+                  ?behavior: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior,
+                  ?reason: String,
+                  ?source: String
+                ) -> void
+
+                def to_hash: -> {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+                type action = :review | :allow | :reject
+
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW: :review
+                  ALLOW: :allow
+                  REJECT: :reject
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::action]
+                end
+
+                type behavior = :override | :escalate
+
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE: :override
+                  ESCALATE: :escalate
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::behavior]
+                end
+              end
+
               type content =
                 ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Text
                 | ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Image
@@ -3549,6 +3685,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -3566,6 +3703,8 @@ module ModerationAPI
 
               attr_accessor channel_key: String?
 
+              attr_accessor client_action: ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction?
+
               attr_accessor content: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::content
 
               attr_accessor conversation_id: String?
@@ -3586,6 +3725,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -3600,6 +3740,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -3610,6 +3751,69 @@ module ModerationAPI
                 timestamp: Time
               }
 
+              type client_action =
+                {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                attr_accessor action: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::action
+
+                attr_reader behavior: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior?
+
+                def behavior=: (
+                  ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior
+                ) -> ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior
+
+                attr_reader reason: String?
+
+                def reason=: (String) -> String
+
+                attr_reader source: String?
+
+                def source=: (String) -> String
+
+                def initialize: (
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::action,
+                  ?behavior: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior,
+                  ?reason: String,
+                  ?source: String
+                ) -> void
+
+                def to_hash: -> {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+                type action = :review | :allow | :reject
+
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW: :review
+                  ALLOW: :allow
+                  REJECT: :reject
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::action]
+                end
+
+                type behavior = :override | :escalate
+
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE: :override
+                  ESCALATE: :escalate
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::behavior]
+                end
+              end
+
               type content =
                 ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Text
                 | ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Image
@@ -4303,6 +4507,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -4320,6 +4525,8 @@ module ModerationAPI
 
               attr_accessor channel_key: String?
 
+              attr_accessor client_action: ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction?
+
               attr_accessor content: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::content
 
               attr_accessor conversation_id: String?
@@ -4340,6 +4547,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -4354,6 +4562,7 @@ module ModerationAPI
                 id: String,
                 author_id: String?,
                 channel_key: String?,
+                client_action: ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction?,
                 content: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::content,
                 conversation_id: String?,
                 flagged: bool?,
@@ -4364,6 +4573,69 @@ module ModerationAPI
                 timestamp: Time
               }
 
+              type client_action =
+                {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                attr_accessor action: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::action
+
+                attr_reader behavior: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior?
+
+                def behavior=: (
+                  ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior
+                ) -> ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior
+
+                attr_reader reason: String?
+
+                def reason=: (String) -> String
+
+                attr_reader source: String?
+
+                def source=: (String) -> String
+
+                def initialize: (
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::action,
+                  ?behavior: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior,
+                  ?reason: String,
+                  ?source: String
+                ) -> void
+
+                def to_hash: -> {
+                  action: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::action,
+                  behavior: ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior,
+                  reason: String,
+                  source: String
+                }
+
+                type action = :review | :allow | :reject
+
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  REVIEW: :review
+                  ALLOW: :allow
+                  REJECT: :reject
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::action]
+                end
+
+                type behavior = :override | :escalate
+
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  OVERRIDE: :override
+                  ESCALATE: :escalate
+
+                  def self?.values: -> ::Array[ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::behavior]
+                end
+              end
+
               type content =
                 ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Text
                 | ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Image

data/sig/moderation_api/resources/content.rbs

@@ -5,6 +5,7 @@ module ModerationAPI
         content: ModerationAPI::Models::ContentSubmitParams::content,
         ?author_id: String,
         ?channel: String,
+        ?client_action: ModerationAPI::ContentSubmitParams::ClientAction,
         ?content_id: String,
         ?conversation_id: String,
         ?do_not_store: bool,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moderation_api
 version: !ruby/object:Gem::Version
-  version: 2.19.0
+  version: 2.21.0
 platform: ruby
 authors:
 - Moderation API
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi