whop_sdk 0.0.3 → 0.0.5

data/lib/whop_sdk/models/course_student_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::CourseStudents#retrieve
+    class CourseStudentRetrieveParams < WhopSDK::Internal::Type::BaseModel
+      extend WhopSDK::Internal::Type::RequestParameters::Converter
+      include WhopSDK::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/whop_sdk/models/course_student_retrieve_response.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # @see WhopSDK::Resources::CourseStudents#retrieve
+    class CourseStudentRetrieveResponse < WhopSDK::Internal::Type::BaseModel
+      # @!attribute id
+      #   The ID of the course student. Looks like crsi_XXX
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute completed_lessons_count
+      #   The number of lessons the student has completed
+      #
+      #   @return [Integer]
+      required :completed_lessons_count, Integer
+
+      # @!attribute completion_rate
+      #   The percentage of lessons completed (0-100)
+      #
+      #   @return [Float]
+      required :completion_rate, Float
+
+      # @!attribute course
+      #   The course the student is enrolled in
+      #
+      #   @return [WhopSDK::Models::CourseStudentRetrieveResponse::Course]
+      required :course, -> { WhopSDK::Models::CourseStudentRetrieveResponse::Course }
+
+      # @!attribute first_interaction_at
+      #   When the student first interacted with the course
+      #
+      #   @return [Time]
+      required :first_interaction_at, Time
+
+      # @!attribute last_interaction_at
+      #   When the student last interacted with the course
+      #
+      #   @return [Time]
+      required :last_interaction_at, Time
+
+      # @!attribute total_lessons_count
+      #   The total number of lessons the student has access to
+      #
+      #   @return [Integer]
+      required :total_lessons_count, Integer
+
+      # @!attribute user
+      #   The user who is enrolled in the course
+      #
+      #   @return [WhopSDK::Models::CourseStudentRetrieveResponse::User]
+      required :user, -> { WhopSDK::Models::CourseStudentRetrieveResponse::User }
+
+      # @!method initialize(id:, completed_lessons_count:, completion_rate:, course:, first_interaction_at:, last_interaction_at:, total_lessons_count:, user:)
+      #   A course student (enrollment of a student in a course)
+      #
+      #   @param id [String] The ID of the course student. Looks like crsi_XXX
+      #
+      #   @param completed_lessons_count [Integer] The number of lessons the student has completed
+      #
+      #   @param completion_rate [Float] The percentage of lessons completed (0-100)
+      #
+      #   @param course [WhopSDK::Models::CourseStudentRetrieveResponse::Course] The course the student is enrolled in
+      #
+      #   @param first_interaction_at [Time] When the student first interacted with the course
+      #
+      #   @param last_interaction_at [Time] When the student last interacted with the course
+      #
+      #   @param total_lessons_count [Integer] The total number of lessons the student has access to
+      #
+      #   @param user [WhopSDK::Models::CourseStudentRetrieveResponse::User] The user who is enrolled in the course
+
+      # @see WhopSDK::Models::CourseStudentRetrieveResponse#course
+      class Course < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of the course. Looks like cors_XXX
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute experience
+        #   The experience that the course belongs to
+        #
+        #   @return [WhopSDK::Models::CourseStudentRetrieveResponse::Course::Experience]
+        required :experience, -> { WhopSDK::Models::CourseStudentRetrieveResponse::Course::Experience }
+
+        # @!attribute title
+        #   The title of the course
+        #
+        #   @return [String, nil]
+        required :title, String, nil?: true
+
+        # @!method initialize(id:, experience:, title:)
+        #   The course the student is enrolled in
+        #
+        #   @param id [String] The ID of the course. Looks like cors_XXX
+        #
+        #   @param experience [WhopSDK::Models::CourseStudentRetrieveResponse::Course::Experience] The experience that the course belongs to
+        #
+        #   @param title [String, nil] The title of the course
+
+        # @see WhopSDK::Models::CourseStudentRetrieveResponse::Course#experience
+        class Experience < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID representing this experience
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   The experience that the course belongs to
+          #
+          #   @param id [String] The unique ID representing this experience
+        end
+      end
+
+      # @see WhopSDK::Models::CourseStudentRetrieveResponse#user
+      class User < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The internal ID of the user.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute name
+        #   The name of the user from their Whop account.
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!attribute username
+        #   The username of the user from their Whop account.
+        #
+        #   @return [String]
+        required :username, String
+
+        # @!method initialize(id:, name:, username:)
+        #   The user who is enrolled in the course
+        #
+        #   @param id [String] The internal ID of the user.
+        #
+        #   @param name [String, nil] The name of the user from their Whop account.
+        #
+        #   @param username [String] The username of the user from their Whop account.
+      end
+    end
+  end
+end

data/lib/whop_sdk/models/course_update_params.rb

@@ -40,6 +40,13 @@ module WhopSDK
       #   @return [Symbol, WhopSDK::Models::Languages, nil]
       optional :language, enum: -> { WhopSDK::Languages }, nil?: true
 
+      # @!attribute order
+      #   The decimal order position of the course within its experience. Use fractional
+      #   values (e.g., 1.5) to place between existing courses.
+      #
+      #   @return [String, nil]
+      optional :order, String, nil?: true
+
       # @!attribute require_completing_lessons_in_order
       #   Whether the course requires students to complete the previous lesson before
       #   moving on to the next one
@@ -56,8 +63,8 @@ module WhopSDK
       # @!attribute thumbnail
       #   The thumbnail for the course in png, jpeg, or gif format
       #
-      #   @return [WhopSDK::Models::CourseUpdateParams::Thumbnail, nil]
-      optional :thumbnail, -> { WhopSDK::CourseUpdateParams::Thumbnail }, nil?: true
+      #   @return [WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithDirectUploadID, WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithID, nil]
+      optional :thumbnail, union: -> { WhopSDK::CourseUpdateParams::Thumbnail }, nil?: true
 
       # @!attribute title
       #   The title of the course
@@ -65,7 +72,14 @@ module WhopSDK
       #   @return [String, nil]
       optional :title, String, nil?: true
 
-      # @!method initialize(certificate_after_completion_enabled: nil, chapters: nil, cover_image: nil, description: nil, language: nil, require_completing_lessons_in_order: nil, tagline: nil, thumbnail: nil, title: nil, request_options: {})
+      # @!attribute visibility
+      #   The available visibilities for a course. Determines how / whether a course is
+      #   visible to users.
+      #
+      #   @return [Symbol, WhopSDK::Models::CourseVisibilities, nil]
+      optional :visibility, enum: -> { WhopSDK::CourseVisibilities }, nil?: true
+
+      # @!method initialize(certificate_after_completion_enabled: nil, chapters: nil, cover_image: nil, description: nil, language: nil, order: nil, require_completing_lessons_in_order: nil, tagline: nil, thumbnail: nil, title: nil, visibility: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {WhopSDK::Models::CourseUpdateParams} for more details.
       #
@@ -79,14 +93,18 @@ module WhopSDK
       #
       #   @param language [Symbol, WhopSDK::Models::Languages, nil] The available languages for a course
       #
+      #   @param order [String, nil] The decimal order position of the course within its experience. Use fractional v
+      #
       #   @param require_completing_lessons_in_order [Boolean, nil] Whether the course requires students to complete the previous lesson before movi
       #
       #   @param tagline [String, nil] A short tagline for the course
       #
-      #   @param thumbnail [WhopSDK::Models::CourseUpdateParams::Thumbnail, nil] The thumbnail for the course in png, jpeg, or gif format
+      #   @param thumbnail [WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithDirectUploadID, WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithID, nil] The thumbnail for the course in png, jpeg, or gif format
       #
       #   @param title [String, nil] The title of the course
       #
+      #   @param visibility [Symbol, WhopSDK::Models::CourseVisibilities, nil] The available visibilities for a course. Determines how / whether a course is vi
+      #
       #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
 
       class Chapter < WhopSDK::Internal::Type::BaseModel
@@ -165,32 +183,56 @@ module WhopSDK
         end
       end
 
-      class Thumbnail < WhopSDK::Internal::Type::BaseModel
-        # @!attribute id
-        #   The ID of an existing attachment object. Use this when updating a resource and
-        #   keeping a subset of the attachments. Don't use this unless you know what you're
-        #   doing.
-        #
-        #   @return [String, nil]
-        optional :id, String, nil?: true
+      # The thumbnail for the course in png, jpeg, or gif format
+      module Thumbnail
+        extend WhopSDK::Internal::Type::Union
 
-        # @!attribute direct_upload_id
-        #   This ID should be used the first time you upload an attachment. It is the ID of
-        #   the direct upload that was created when uploading the file to S3 via the
-        #   mediaDirectUpload mutation.
-        #
-        #   @return [String, nil]
-        optional :direct_upload_id, String, nil?: true
+        # Input for an attachment
+        variant -> { WhopSDK::CourseUpdateParams::Thumbnail::AttachmentInputWithDirectUploadID }
 
-        # @!method initialize(id: nil, direct_upload_id: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {WhopSDK::Models::CourseUpdateParams::Thumbnail} for more details.
-        #
-        #   The thumbnail for the course in png, jpeg, or gif format
-        #
-        #   @param id [String, nil] The ID of an existing attachment object. Use this when updating a resource and k
-        #
-        #   @param direct_upload_id [String, nil] This ID should be used the first time you upload an attachment. It is the ID of
+        # Input for an attachment
+        variant -> { WhopSDK::CourseUpdateParams::Thumbnail::AttachmentInputWithID }
+
+        class AttachmentInputWithDirectUploadID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute direct_upload_id
+          #   This ID should be used the first time you upload an attachment. It is the ID of
+          #   the direct upload that was created when uploading the file to S3 via the
+          #   mediaDirectUpload mutation.
+          #
+          #   @return [String]
+          required :direct_upload_id, String
+
+          # @!method initialize(direct_upload_id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithDirectUploadID}
+          #   for more details.
+          #
+          #   Input for an attachment
+          #
+          #   @param direct_upload_id [String] This ID should be used the first time you upload an attachment. It is the ID of
+        end
+
+        class AttachmentInputWithID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of an existing attachment object. Use this when updating a resource and
+          #   keeping a subset of the attachments. Don't use this unless you know what you're
+          #   doing.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithID} for more
+          #   details.
+          #
+          #   Input for an attachment
+          #
+          #   @param id [String] The ID of an existing attachment object. Use this when updating a resource and k
+        end
+
+        # @!method self.variants
+        #   @return [Array(WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithDirectUploadID, WhopSDK::Models::CourseUpdateParams::Thumbnail::AttachmentInputWithID)]
       end
     end
   end

data/lib/whop_sdk/models/course_visibilities.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # The available visibilities for a course. Determines how / whether a course is
+    # visible to users.
+    module CourseVisibilities
+      extend WhopSDK::Internal::Type::Enum
+
+      VISIBLE = :visible
+      HIDDEN = :hidden
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/whop_sdk/models/embed_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module WhopSDK
+  module Models
+    # The type of embed for a lesson
+    module EmbedType
+      extend WhopSDK::Internal::Type::Enum
+
+      YOUTUBE = :youtube
+      LOOM = :loom
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/whop_sdk/models/entry.rb

@@ -30,7 +30,7 @@ module WhopSDK
       required :plan, -> { WhopSDK::Entry::Plan }, nil?: true
 
       # @!attribute product
-      #   The access pass tied to this entry, if there is one.
+      #   The product tied to this entry, if there is one.
       #
       #   @return [WhopSDK::Models::Entry::Product, nil]
       required :product, -> { WhopSDK::Entry::Product }, nil?: true
@@ -58,7 +58,7 @@ module WhopSDK
       #
       #   @param plan [WhopSDK::Models::Entry::Plan, nil] The waitlist plan the entry if for.
       #
-      #   @param product [WhopSDK::Models::Entry::Product, nil] The access pass tied to this entry, if there is one.
+      #   @param product [WhopSDK::Models::Entry::Product, nil] The product tied to this entry, if there is one.
       #
       #   @param status [Symbol, WhopSDK::Models::EntryStatus] The status of the entry.
       #
@@ -122,7 +122,7 @@ module WhopSDK
         required :title, String
 
         # @!method initialize(id:, title:)
-        #   The access pass tied to this entry, if there is one.
+        #   The product tied to this entry, if there is one.
         #
         #   @param id [String] The internal ID of the public product.
         #

data/lib/whop_sdk/models/entry_list_response.rb

@@ -23,7 +23,7 @@ module WhopSDK
       required :plan, -> { WhopSDK::Models::EntryListResponse::Plan }, nil?: true
 
       # @!attribute product
-      #   The access pass tied to this entry, if there is one.
+      #   The product tied to this entry, if there is one.
       #
       #   @return [WhopSDK::Models::EntryListResponse::Product, nil]
       required :product, -> { WhopSDK::Models::EntryListResponse::Product }, nil?: true
@@ -49,7 +49,7 @@ module WhopSDK
       #
       #   @param plan [WhopSDK::Models::EntryListResponse::Plan, nil] The waitlist plan the entry if for.
       #
-      #   @param product [WhopSDK::Models::EntryListResponse::Product, nil] The access pass tied to this entry, if there is one.
+      #   @param product [WhopSDK::Models::EntryListResponse::Product, nil] The product tied to this entry, if there is one.
       #
       #   @param status [Symbol, WhopSDK::Models::EntryStatus] The status of the entry.
       #
@@ -84,7 +84,7 @@ module WhopSDK
         required :title, String
 
         # @!method initialize(id:, title:)
-        #   The access pass tied to this entry, if there is one.
+        #   The product tied to this entry, if there is one.
         #
         #   @param id [String] The internal ID of the public product.
         #

data/lib/whop_sdk/models/experience.rb

@@ -46,10 +46,9 @@ module WhopSDK
       required :order, String, nil?: true
 
       # @!attribute products
-      #   The access passes that are associated with this experience. This should not be
-      #   used unless you are trying to list all access passes the experience has, for
-      #   some reason. You probably don't want to use this though and should be using
-      #   accessPass.
+      #   The products that this experience is attached to. This defines which set of
+      #   customers have access and can view this experience. If empty, this experience is
+      #   only visible to authorized users of the company
       #
       #   @return [Array<WhopSDK::Models::Experience::Product>]
       required :products, -> { WhopSDK::Internal::Type::ArrayOf[WhopSDK::Experience::Product] }
@@ -74,7 +73,7 @@ module WhopSDK
       #
       #   @param order [String, nil] The order of the experience in the section
       #
-      #   @param products [Array<WhopSDK::Models::Experience::Product>] The access passes that are associated with this experience. This should not be u
+      #   @param products [Array<WhopSDK::Models::Experience::Product>] The products that this experience is attached to. This defines which set of cust
 
       # @see WhopSDK::Models::Experience#app
       class App < WhopSDK::Internal::Type::BaseModel
@@ -197,7 +196,7 @@ module WhopSDK
         required :title, String
 
         # @!method initialize(id:, route:, title:)
-        #   An object representing a (sanitized) access pass.
+        #   Represents a product on whop. Use products to sell anything on the platform.
         #
         #   @param id [String] The internal ID of the public product.
         #

data/lib/whop_sdk/models/experience_update_params.rb

@@ -16,8 +16,8 @@ module WhopSDK
       # @!attribute logo
       #   The logo for the experience
       #
-      #   @return [WhopSDK::Models::ExperienceUpdateParams::Logo, nil]
-      optional :logo, -> { WhopSDK::ExperienceUpdateParams::Logo }, nil?: true
+      #   @return [WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithDirectUploadID, WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithID, nil]
+      optional :logo, union: -> { WhopSDK::ExperienceUpdateParams::Logo }, nil?: true
 
       # @!attribute name
       #   The name of the experience.
@@ -40,7 +40,7 @@ module WhopSDK
       # @!method initialize(access_level: nil, logo: nil, name: nil, order: nil, section_id: nil, request_options: {})
       #   @param access_level [Symbol, WhopSDK::Models::ExperienceUpdateParams::AccessLevel, nil] The different access levels for experiences (PUBLIC IS NEVER USED ANYMORE).
       #
-      #   @param logo [WhopSDK::Models::ExperienceUpdateParams::Logo, nil] The logo for the experience
+      #   @param logo [WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithDirectUploadID, WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithID, nil] The logo for the experience
       #
       #   @param name [String, nil] The name of the experience.
       #
@@ -61,32 +61,56 @@ module WhopSDK
         #   @return [Array<Symbol>]
       end
 
-      class Logo < WhopSDK::Internal::Type::BaseModel
-        # @!attribute id
-        #   The ID of an existing attachment object. Use this when updating a resource and
-        #   keeping a subset of the attachments. Don't use this unless you know what you're
-        #   doing.
-        #
-        #   @return [String, nil]
-        optional :id, String, nil?: true
-
-        # @!attribute direct_upload_id
-        #   This ID should be used the first time you upload an attachment. It is the ID of
-        #   the direct upload that was created when uploading the file to S3 via the
-        #   mediaDirectUpload mutation.
-        #
-        #   @return [String, nil]
-        optional :direct_upload_id, String, nil?: true
-
-        # @!method initialize(id: nil, direct_upload_id: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {WhopSDK::Models::ExperienceUpdateParams::Logo} for more details.
-        #
-        #   The logo for the experience
-        #
-        #   @param id [String, nil] The ID of an existing attachment object. Use this when updating a resource and k
-        #
-        #   @param direct_upload_id [String, nil] This ID should be used the first time you upload an attachment. It is the ID of
+      # The logo for the experience
+      module Logo
+        extend WhopSDK::Internal::Type::Union
+
+        # Input for an attachment
+        variant -> { WhopSDK::ExperienceUpdateParams::Logo::AttachmentInputWithDirectUploadID }
+
+        # Input for an attachment
+        variant -> { WhopSDK::ExperienceUpdateParams::Logo::AttachmentInputWithID }
+
+        class AttachmentInputWithDirectUploadID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute direct_upload_id
+          #   This ID should be used the first time you upload an attachment. It is the ID of
+          #   the direct upload that was created when uploading the file to S3 via the
+          #   mediaDirectUpload mutation.
+          #
+          #   @return [String]
+          required :direct_upload_id, String
+
+          # @!method initialize(direct_upload_id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithDirectUploadID}
+          #   for more details.
+          #
+          #   Input for an attachment
+          #
+          #   @param direct_upload_id [String] This ID should be used the first time you upload an attachment. It is the ID of
+        end
+
+        class AttachmentInputWithID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of an existing attachment object. Use this when updating a resource and
+          #   keeping a subset of the attachments. Don't use this unless you know what you're
+          #   doing.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithID} for more
+          #   details.
+          #
+          #   Input for an attachment
+          #
+          #   @param id [String] The ID of an existing attachment object. Use this when updating a resource and k
+        end
+
+        # @!method self.variants
+        #   @return [Array(WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithDirectUploadID, WhopSDK::Models::ExperienceUpdateParams::Logo::AttachmentInputWithID)]
       end
     end
   end

data/lib/whop_sdk/models/forum_post.rb

@@ -4,7 +4,7 @@ module WhopSDK
   module Models
     class ForumPost < WhopSDK::Internal::Type::BaseModel
       # @!attribute id
-      #   The unique identifier for the entity
+      #   The unique identifier of the resource.
       #
       #   @return [String]
       required :id, String
@@ -84,7 +84,7 @@ module WhopSDK
       # @!method initialize(id:, comment_count:, content:, created_at:, is_edited:, is_pinned:, is_poster_admin:, like_count:, parent_id:, title:, updated_at:, user:, view_count:)
       #   Represents a post in forum
       #
-      #   @param id [String] The unique identifier for the entity
+      #   @param id [String] The unique identifier of the resource.
       #
       #   @param comment_count [Integer] The amount of comments on this post
       #

data/lib/whop_sdk/models/forum_post_create_params.rb

@@ -16,9 +16,9 @@ module WhopSDK
       # @!attribute attachments
       #   The attachments for this post
       #
-      #   @return [Array<WhopSDK::Models::ForumPostCreateParams::Attachment>, nil]
+      #   @return [Array<WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithDirectUploadID, WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithID>, nil]
       optional :attachments,
-               -> { WhopSDK::Internal::Type::ArrayOf[WhopSDK::ForumPostCreateParams::Attachment] },
+               -> { WhopSDK::Internal::Type::ArrayOf[union: WhopSDK::ForumPostCreateParams::Attachment] },
                nil?: true
 
       # @!attribute content
@@ -80,7 +80,7 @@ module WhopSDK
       #
       #   @param experience_id [String] The experience to create this post in
       #
-      #   @param attachments [Array<WhopSDK::Models::ForumPostCreateParams::Attachment>, nil] The attachments for this post
+      #   @param attachments [Array<WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithDirectUploadID, WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithID>, nil] The attachments for this post
       #
       #   @param content [String, nil] This is the main body of the post in Markdown format. Hidden if paywalled and us
       #
@@ -100,32 +100,56 @@ module WhopSDK
       #
       #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
 
-      class Attachment < WhopSDK::Internal::Type::BaseModel
-        # @!attribute id
-        #   The ID of an existing attachment object. Use this when updating a resource and
-        #   keeping a subset of the attachments. Don't use this unless you know what you're
-        #   doing.
-        #
-        #   @return [String, nil]
-        optional :id, String, nil?: true
+      # Input for an attachment
+      module Attachment
+        extend WhopSDK::Internal::Type::Union
 
-        # @!attribute direct_upload_id
-        #   This ID should be used the first time you upload an attachment. It is the ID of
-        #   the direct upload that was created when uploading the file to S3 via the
-        #   mediaDirectUpload mutation.
-        #
-        #   @return [String, nil]
-        optional :direct_upload_id, String, nil?: true
+        # Input for an attachment
+        variant -> { WhopSDK::ForumPostCreateParams::Attachment::AttachmentInputWithDirectUploadID }
 
-        # @!method initialize(id: nil, direct_upload_id: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {WhopSDK::Models::ForumPostCreateParams::Attachment} for more details.
-        #
-        #   Input for an attachment
-        #
-        #   @param id [String, nil] The ID of an existing attachment object. Use this when updating a resource and k
-        #
-        #   @param direct_upload_id [String, nil] This ID should be used the first time you upload an attachment. It is the ID of
+        # Input for an attachment
+        variant -> { WhopSDK::ForumPostCreateParams::Attachment::AttachmentInputWithID }
+
+        class AttachmentInputWithDirectUploadID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute direct_upload_id
+          #   This ID should be used the first time you upload an attachment. It is the ID of
+          #   the direct upload that was created when uploading the file to S3 via the
+          #   mediaDirectUpload mutation.
+          #
+          #   @return [String]
+          required :direct_upload_id, String
+
+          # @!method initialize(direct_upload_id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithDirectUploadID}
+          #   for more details.
+          #
+          #   Input for an attachment
+          #
+          #   @param direct_upload_id [String] This ID should be used the first time you upload an attachment. It is the ID of
+        end
+
+        class AttachmentInputWithID < WhopSDK::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of an existing attachment object. Use this when updating a resource and
+          #   keeping a subset of the attachments. Don't use this unless you know what you're
+          #   doing.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Some parameter documentations has been truncated, see
+          #   {WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithID} for
+          #   more details.
+          #
+          #   Input for an attachment
+          #
+          #   @param id [String] The ID of an existing attachment object. Use this when updating a resource and k
+        end
+
+        # @!method self.variants
+        #   @return [Array(WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithDirectUploadID, WhopSDK::Models::ForumPostCreateParams::Attachment::AttachmentInputWithID)]
       end
 
       class Poll < WhopSDK::Internal::Type::BaseModel