moderation_api 2.20.0 → 2.22.0

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
               #
@@ -2454,6 +2464,13 @@ module ModerationAPI
               #   @return [Boolean, nil]
               required :flagged, ModerationAPI::Internal::Type::Boolean, nil?: true
 
+              # @!attribute flagged_fields
+              #   For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              #   when no fields were flagged or the content is not an object.
+              #
+              #   @return [Array<String>]
+              required :flagged_fields, ModerationAPI::Internal::Type::ArrayOf[String]
+
               # @!attribute labels
               #   Moderation labels applied to the content
               #
@@ -2496,7 +2513,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:, flagged_fields:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item} for
               #   more details.
@@ -2507,12 +2524,16 @@ 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
               #
               #   @param flagged [Boolean, nil] Whether the content was flagged by moderation
               #
+              #   @param flagged_fields [Array<String>] For object content, the field keys (e.g. "bio") that triggered a flag. Empty whe
+              #
               #   @param labels [Array<ModerationAPI::Models::WebhookEvent::QueueItemResolved::Data::Object::Item::Label>, nil] Moderation labels applied to the content
               #
               #   @param language [String, nil] Detected ISO language code, if available
@@ -2523,6 +2544,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 +3793,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
               #
@@ -3717,6 +3819,13 @@ module ModerationAPI
               #   @return [Boolean, nil]
               required :flagged, ModerationAPI::Internal::Type::Boolean, nil?: true
 
+              # @!attribute flagged_fields
+              #   For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              #   when no fields were flagged or the content is not an object.
+              #
+              #   @return [Array<String>]
+              required :flagged_fields, ModerationAPI::Internal::Type::ArrayOf[String]
+
               # @!attribute labels
               #   Moderation labels applied to the content
               #
@@ -3759,7 +3868,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:, flagged_fields:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item} for
               #   more details.
@@ -3772,12 +3881,16 @@ 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
               #
               #   @param flagged [Boolean, nil] Whether the content was flagged by moderation
               #
+              #   @param flagged_fields [Array<String>] For object content, the field keys (e.g. "bio") that triggered a flag. Empty whe
+              #
               #   @param labels [Array<ModerationAPI::Models::WebhookEvent::QueueItemAction::Data::Object::Item::Label>, nil] Moderation labels applied to the content
               #
               #   @param language [String, nil] Detected ISO language code, if available
@@ -3788,6 +3901,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 +4868,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
               #
@@ -4701,6 +4897,13 @@ module ModerationAPI
               #   @return [Boolean, nil]
               required :flagged, ModerationAPI::Internal::Type::Boolean, nil?: true
 
+              # @!attribute flagged_fields
+              #   For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              #   when no fields were flagged or the content is not an object.
+              #
+              #   @return [Array<String>]
+              required :flagged_fields, ModerationAPI::Internal::Type::ArrayOf[String]
+
               # @!attribute labels
               #   Moderation labels applied to the content
               #
@@ -4743,7 +4946,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:, flagged_fields:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item} for
               #   more details.
@@ -4756,12 +4959,16 @@ 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
               #
               #   @param flagged [Boolean, nil] Whether the content was flagged by moderation
               #
+              #   @param flagged_fields [Array<String>] For object content, the field keys (e.g. "bio") that triggered a flag. Empty whe
+              #
               #   @param labels [Array<ModerationAPI::Models::WebhookEvent::QueueItemRejected::Data::Object::Item::Label>, nil] Moderation labels applied to the content
               #
               #   @param language [String, nil] Detected ISO language code, if available
@@ -4772,6 +4979,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 +5945,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
               #
@@ -5684,6 +5972,13 @@ module ModerationAPI
               #   @return [Boolean, nil]
               required :flagged, ModerationAPI::Internal::Type::Boolean, nil?: true
 
+              # @!attribute flagged_fields
+              #   For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              #   when no fields were flagged or the content is not an object.
+              #
+              #   @return [Array<String>]
+              required :flagged_fields, ModerationAPI::Internal::Type::ArrayOf[String]
+
               # @!attribute labels
               #   Moderation labels applied to the content
               #
@@ -5726,7 +6021,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:, flagged_fields:, labels:, language:, meta_type:, metadata:, timestamp:)
               #   Some parameter documentations has been truncated, see
               #   {ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item} for
               #   more details.
@@ -5739,12 +6034,16 @@ 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
               #
               #   @param flagged [Boolean, nil] Whether the content was flagged by moderation
               #
+              #   @param flagged_fields [Array<String>] For object content, the field keys (e.g. "bio") that triggered a flag. Empty whe
+              #
               #   @param labels [Array<ModerationAPI::Models::WebhookEvent::QueueItemAllowed::Data::Object::Item::Label>, nil] Moderation labels applied to the content
               #
               #   @param language [String, nil] Detected ISO language code, if available
@@ -5755,6 +6054,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.22.0"
 end