whop_sdk 0.0.26 → 0.0.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a80be479329709bdcbe983b4d0e2319dfb9f42720475ed5da78872b9510c2e2
-  data.tar.gz: 8ab39c69907d254193380ce538039600ae3da39cb82058827124e58fe2b33632
+  metadata.gz: 65d1daae72b60c920b505a3d0d31fa263abea2a5c3d7d64f3f08a28dd1ca19b8
+  data.tar.gz: ff1e4ffb828933835fc5d71a89c7fd64cc5fbf06cc925d72f5cd666feb24f612
 SHA512:
-  metadata.gz: 54302147cc07d4734043c43e8db74fef84a67ac3b6a4e123bf4f6135c3cbc2f7bd27292caa3805ce6cc00e6b6f2395637c6463c938fb193d3bea763781a39132
-  data.tar.gz: '0842d8980e5bc4c49e6f37e443e50ae5c1d8aa1610e2e7167d19c5499f47af47393e9e10944c4f8bd90b0f91e3a889fe93f7751d81ebb381df2cba133d4d29d9'
+  metadata.gz: ca8f9e650c7cf95c9c542f8a8f0d875c898edcbf3206ec04aa2b74073da7081bf4bbbbbcb0d4f2e856a693a277c8caf195efb3aa753a8ca82e36d405e034c3be
+  data.tar.gz: bb1912a81b99c2bf887636a855d30a82cebe518b3f6948523794279e2b513f037f8f8b1e597c44c72ed41c1549e6bddd0a8ed4b0265d47f16581f20675d2cabf

data/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## 0.0.28 (2026-02-19)
+
+Full Changelog: [v0.0.27...v0.0.28](https://github.com/whopio/whopsdk-ruby/compare/v0.0.27...v0.0.28)
+
+### Features
+
+* **api:** api update ([19a8f84](https://github.com/whopio/whopsdk-ruby/commit/19a8f842c19aec2b89cb06edb301d31144ff8f6f))
+* **api:** api update ([9a84f83](https://github.com/whopio/whopsdk-ruby/commit/9a84f83c5637fcf915631af3ce01216c9ab96617))
+* **api:** api update ([a87dffa](https://github.com/whopio/whopsdk-ruby/commit/a87dffa1f3f8c8e88605bf443c565d55f92b8207))
+* **api:** api update ([193161d](https://github.com/whopio/whopsdk-ruby/commit/193161dc23d8868a252b4f98ad550d22b3dabac7))
+* **api:** api update ([5ce4893](https://github.com/whopio/whopsdk-ruby/commit/5ce4893f759e45aadf3703b5d8074b61d333e903))
+* **api:** api update ([3d480a8](https://github.com/whopio/whopsdk-ruby/commit/3d480a8c7b7d440c4edfa1067b156c88a7c07efd))
+* **api:** api update ([1721944](https://github.com/whopio/whopsdk-ruby/commit/1721944bb515a5ee1eecb3f7ba43eea96763b00b))
+* **api:** api update ([3b32134](https://github.com/whopio/whopsdk-ruby/commit/3b321344577fa04c3cb70743bd381108fafdc7c2))
+* **api:** api update ([c4dbb11](https://github.com/whopio/whopsdk-ruby/commit/c4dbb11f8dd3862aa616d63387f96a5ae62392c0))
+* **api:** api update ([a6cec2c](https://github.com/whopio/whopsdk-ruby/commit/a6cec2c09ed799f3d6607d884f543653fb490b57))
+* **api:** api update ([f173bf9](https://github.com/whopio/whopsdk-ruby/commit/f173bf9fa8441ed9cd7fcd92f241dd2d1972e057))
+* **api:** api update ([3fa5697](https://github.com/whopio/whopsdk-ruby/commit/3fa56971b88284df0612640c581e446205d9b5b6))
+* **api:** api update ([63accfc](https://github.com/whopio/whopsdk-ruby/commit/63accfc1df49a36eead79abc81d75f3d4ebf7ce9))
+* **api:** api update ([7eada7c](https://github.com/whopio/whopsdk-ruby/commit/7eada7c05cb4f18d8d84dba1a0c22ca4a61cf460))
+* **api:** api update ([b3c3d77](https://github.com/whopio/whopsdk-ruby/commit/b3c3d77fe6c08d878e4983beacf9fb6b4a84b238))
+* **api:** api update ([6d1c4e9](https://github.com/whopio/whopsdk-ruby/commit/6d1c4e99fe46d43a67aba8bac62ad6347cf22d1c))
+* **api:** api update ([bb02a5e](https://github.com/whopio/whopsdk-ruby/commit/bb02a5ebaa149af41f46d860e0f6da07dec20c0f))
+* **api:** api update ([1957770](https://github.com/whopio/whopsdk-ruby/commit/1957770a92a4fba413f9277312aabeac1ba51dad))
+* **api:** api update ([929026d](https://github.com/whopio/whopsdk-ruby/commit/929026d0eee42ab7f930f81bbeb582348d8b5b8b))
+* **api:** manual updates ([1bd14df](https://github.com/whopio/whopsdk-ruby/commit/1bd14df4007aedf72be1206f27fce029609660b1))
+* **api:** manual updates ([7c05fd4](https://github.com/whopio/whopsdk-ruby/commit/7c05fd452333841f7ca142cd235d922bb281b94a))
+* **api:** manual updates ([023f1ca](https://github.com/whopio/whopsdk-ruby/commit/023f1ca270e0caf1c53fdcd2897a66ac3aa2d863))
+
+
+### Chores
+
+* configure new SDK language ([8483357](https://github.com/whopio/whopsdk-ruby/commit/8483357ba5ca5b76ebb4ec832b40861982adf85f))
+
+## 0.0.27 (2026-02-09)
+
+Full Changelog: [v0.0.26...v0.0.27](https://github.com/whopio/whopsdk-ruby/compare/v0.0.26...v0.0.27)
+
+### Features
+
+* **api:** api update ([65ed264](https://github.com/whopio/whopsdk-ruby/commit/65ed2647981ae0aba98d848dcf31d40303785c35))
+* **api:** api update ([5337616](https://github.com/whopio/whopsdk-ruby/commit/5337616fe580b2afa16b2210eb2113a2755c8529))
+* **api:** api update ([2bec9bc](https://github.com/whopio/whopsdk-ruby/commit/2bec9bc09fbd1a3b41ef8c1ef4bc57a339db43ea))
+* **api:** api update ([0900d40](https://github.com/whopio/whopsdk-ruby/commit/0900d40866a9819b082ccfbe51a531439c5619d8))
+* **api:** api update ([adcace1](https://github.com/whopio/whopsdk-ruby/commit/adcace101df013b38450625f5eacf7573938d902))
+* **api:** api update ([32441bf](https://github.com/whopio/whopsdk-ruby/commit/32441bff9dd037424c7e93be807c3e73250f5b78))
+* **api:** api update ([be694cf](https://github.com/whopio/whopsdk-ruby/commit/be694cff7f498f177f025c75292ce29c800c1658))
+* **api:** api update ([3bdf111](https://github.com/whopio/whopsdk-ruby/commit/3bdf1117e8b6b434b77713fcf534dd112c743ff1))
+* **api:** api update ([71cfae3](https://github.com/whopio/whopsdk-ruby/commit/71cfae32a386c17a95fd5d82a24ae70ec7f5417d))
+* **api:** manual updates ([1cf2d62](https://github.com/whopio/whopsdk-ruby/commit/1cf2d62a8da26bd66c578465980e3600d14e2a94))
+* **api:** manual updates ([60c21fa](https://github.com/whopio/whopsdk-ruby/commit/60c21fa901ca211970592fa6b0ae6650c11a7fc8))
+* **api:** manual updates ([6ea51d3](https://github.com/whopio/whopsdk-ruby/commit/6ea51d3e2a8809d552d1905e6dff99c19e5b1403))
+
+
+### Bug Fixes
+
+* **client:** loosen json header parsing ([1020366](https://github.com/whopio/whopsdk-ruby/commit/1020366437c0cdbba833f84deab255a8902cf610))
+
+
+### Chores
+
+* **docs:** remove www prefix ([d581cb1](https://github.com/whopio/whopsdk-ruby/commit/d581cb174e297c951ac30d0790d48d6a53c046e4))
+
 ## 0.0.26 (2026-02-03)
 
 Full Changelog: [v0.0.25...v0.0.26](https://github.com/whopio/whopsdk-ruby/compare/v0.0.25...v0.0.26)

data/README.md

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

data/lib/whop_sdk/client.rb

@@ -15,7 +15,9 @@ module WhopSDK
     # Default max retry delay in seconds.
     DEFAULT_MAX_RETRY_DELAY = 8.0
 
-    # The app API key from an app from the /dashboard/developer page
+    # A company API key, company scoped JWT, app API key, or user OAuth token. You
+    # must prepend your key/token with the word 'Bearer', which will look like
+    # `Bearer ***************************`
     # @return [String]
     attr_reader :api_key
 
@@ -182,8 +184,9 @@ module WhopSDK
 
     # Creates and returns a new client for interacting with the API.
     #
-    # @param api_key [String, nil] The app API key from an app from the /dashboard/developer page Defaults to
-    # `ENV["WHOP_API_KEY"]`
+    # @param api_key [String, nil] A company API key, company scoped JWT, app API key, or user OAuth token. You
+    # must prepend your key/token with the word 'Bearer', which will look like
+    # `Bearer ***************************` Defaults to `ENV["WHOP_API_KEY"]`
     #
     # @param app_id [String, nil] When using the SDK in app mode pass this parameter to allow verifying user
     # tokens Defaults to `ENV["WHOP_APP_ID"]`

data/lib/whop_sdk/internal/util.rb

@@ -485,7 +485,7 @@ module WhopSDK
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 

data/lib/whop_sdk/models/access_token_create_params.rb

@@ -8,48 +8,45 @@ module WhopSDK
       include WhopSDK::Internal::Type::RequestParameters
 
       # @!attribute company_id
-      #   The ID of the Company to generate the token for. The API key must have
-      #   permission to access this Company, such as the being the company the API key
-      #   belongs to or a sub-merchant of it
+      #   The unique identifier of the company to generate the token for, starting with
+      #   'biz\_'. The API key must have permission to access this company.
       #
-      #   @return [String]
-      required :company_id, String
+      #   @return [String, nil]
+      optional :company_id, String, nil?: true
 
       # @!attribute expires_at
-      #   The expiration timestamp for the access token. If not provided, a default
-      #   expiration time of 1 hour will be used. The expiration can be set to a maximum
-      #   of 3 hours from the current time.
+      #   The expiration timestamp for the access token. Defaults to 1 hour from now, with
+      #   a maximum of 3 hours.
       #
       #   @return [Time, nil]
       optional :expires_at, Time, nil?: true
 
       # @!attribute scoped_actions
-      #   Array of desired scoped actions for the access token. If sent as an empty array
-      #   or not provided, all permissions from the API key making the request will be
-      #   available on the token. If sending an explicit list, they must be a subset of
-      #   the API keys's existing permissions. Otherwise, an error will be raised.
+      #   An array of permission scopes to grant to the access token. If empty or omitted,
+      #   all permissions from the authenticating credential are inherited. Must be a
+      #   subset of the credential's permissions.
       #
       #   @return [Array<String>, nil]
       optional :scoped_actions, WhopSDK::Internal::Type::ArrayOf[String], nil?: true
 
       # @!attribute user_id
-      #   The ID of the User to generate the token for. The API key must have permission
-      #   to access this User.
+      #   The unique identifier of the user to generate the token for, starting with
+      #   'user\_'. The API key must have permission to access this user.
       #
-      #   @return [String]
-      required :user_id, String
+      #   @return [String, nil]
+      optional :user_id, String, nil?: true
 
-      # @!method initialize(company_id:, user_id:, expires_at: nil, scoped_actions: nil, request_options: {})
+      # @!method initialize(company_id: nil, expires_at: nil, scoped_actions: nil, user_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {WhopSDK::Models::AccessTokenCreateParams} for more details.
       #
-      #   @param company_id [String] The ID of the Company to generate the token for. The API key must have permissio
+      #   @param company_id [String, nil] The unique identifier of the company to generate the token for, starting with 'b
       #
-      #   @param user_id [String] The ID of the User to generate the token for. The API key must have permission t
+      #   @param expires_at [Time, nil] The expiration timestamp for the access token. Defaults to 1 hour from now, with
       #
-      #   @param expires_at [Time, nil] The expiration timestamp for the access token. If not provided, a default expira
+      #   @param scoped_actions [Array<String>, nil] An array of permission scopes to grant to the access token. If empty or omitted,
       #
-      #   @param scoped_actions [Array<String>, nil] Array of desired scoped actions for the access token. If sent as an empty array
+      #   @param user_id [String, nil] The unique identifier of the user to generate the token for, starting with 'user
       #
       #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/whop_sdk/models/access_token_create_response.rb

@@ -5,23 +5,29 @@ module WhopSDK
     # @see WhopSDK::Resources::AccessTokens#create
     class AccessTokenCreateResponse < WhopSDK::Internal::Type::BaseModel
       # @!attribute token
-      #   The JWT access token string.
+      #   The signed JWT access token string to include in API request Authorization
+      #   headers.
       #
       #   @return [String]
       required :token, String
 
       # @!attribute expires_at
-      #   The expiration timestamp of the access token.
+      #   The timestamp after which this access token is no longer valid and must be
+      #   refreshed.
       #
       #   @return [Time]
       required :expires_at, Time
 
       # @!method initialize(token:, expires_at:)
-      #   An object representing an access token used for authenticating API requests.
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::AccessTokenCreateResponse} for more details.
       #
-      #   @param token [String] The JWT access token string.
+      #   A short-lived access token used to authenticate API requests on behalf of a
+      #   user.
       #
-      #   @param expires_at [Time] The expiration timestamp of the access token.
+      #   @param token [String] The signed JWT access token string to include in API request Authorization heade
+      #
+      #   @param expires_at [Time] The timestamp after which this access token is no longer valid and must be refre
     end
   end
 end

data/lib/whop_sdk/models/account_link_create_params.rb

@@ -8,27 +8,29 @@ module WhopSDK
       include WhopSDK::Internal::Type::RequestParameters
 
       # @!attribute company_id
-      #   The ID of the Company to generate the url for. The company must be a
-      #   sub-merchant of the API key's company.
+      #   The unique identifier of the company to generate the link for, starting with
+      #   'biz\_'. Must be a sub-merchant of the API key's company.
       #
       #   @return [String]
       required :company_id, String
 
       # @!attribute refresh_url
-      #   The URL to redirect to if the session expires and needs to be re-authenticated
-      #   due to the token expiring.
+      #   The URL to redirect the user to if the session expires and needs to be
+      #   re-authenticated, such as 'https://example.com/refresh'.
       #
       #   @return [String]
       required :refresh_url, String
 
       # @!attribute return_url
-      #   The URL to redirect to when the customer wants to return to your site.
+      #   The URL to redirect the user to when they want to return to your site, such as
+      #   'https://example.com/return'.
       #
       #   @return [String]
       required :return_url, String
 
       # @!attribute use_case
-      #   The use case for which the link will be used.
+      #   The purpose of the account link, such as hosted payouts portal or hosted KYC
+      #   onboarding.
       #
       #   @return [Symbol, WhopSDK::Models::AccountLinkCreateParams::UseCase]
       required :use_case, enum: -> { WhopSDK::AccountLinkCreateParams::UseCase }
@@ -37,17 +39,18 @@ module WhopSDK
       #   Some parameter documentations has been truncated, see
       #   {WhopSDK::Models::AccountLinkCreateParams} for more details.
       #
-      #   @param company_id [String] The ID of the Company to generate the url for. The company must be a sub-merchan
+      #   @param company_id [String] The unique identifier of the company to generate the link for, starting with 'bi
       #
-      #   @param refresh_url [String] The URL to redirect to if the session expires and needs to be re-authenticated d
+      #   @param refresh_url [String] The URL to redirect the user to if the session expires and needs to be re-authen
       #
-      #   @param return_url [String] The URL to redirect to when the customer wants to return to your site.
+      #   @param return_url [String] The URL to redirect the user to when they want to return to your site, such as '
       #
-      #   @param use_case [Symbol, WhopSDK::Models::AccountLinkCreateParams::UseCase] The use case for which the link will be used.
+      #   @param use_case [Symbol, WhopSDK::Models::AccountLinkCreateParams::UseCase] The purpose of the account link, such as hosted payouts portal or hosted KYC onb
       #
       #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
 
-      # The use case for which the link will be used.
+      # The purpose of the account link, such as hosted payouts portal or hosted KYC
+      # onboarding.
       module UseCase
         extend WhopSDK::Internal::Type::Enum
 

data/lib/whop_sdk/models/account_link_create_response.rb

@@ -5,24 +5,28 @@ module WhopSDK
     # @see WhopSDK::Resources::AccountLinks#create
     class AccountLinkCreateResponse < WhopSDK::Internal::Type::BaseModel
       # @!attribute expires_at
-      #   The expiration timestamp of the url.
+      #   The timestamp after which this account link URL is no longer valid.
       #
       #   @return [Time]
       required :expires_at, Time
 
       # @!attribute url
-      #   The URL to navigate the user to.
+      #   The temporary URL to redirect the user to for account access. Expires at the
+      #   time specified by expires_at.
       #
       #   @return [String]
       required :url, String
 
       # @!method initialize(expires_at:, url:)
-      #   An object representing a url that a user can be directed to to access their
-      #   account.
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::AccountLinkCreateResponse} for more details.
       #
-      #   @param expires_at [Time] The expiration timestamp of the url.
+      #   A temporary, time-limited URL that grants a user access to an external account
+      #   management page.
       #
-      #   @param url [String] The URL to navigate the user to.
+      #   @param expires_at [Time] The timestamp after which this account link URL is no longer valid.
+      #
+      #   @param url [String] The temporary URL to redirect the user to for account access. Expires at the tim
     end
   end
 end

data/lib/whop_sdk/models/ai_chat.rb

@@ -5,84 +5,90 @@ module WhopSDK
     # @see WhopSDK::Resources::AIChats#create
     class AIChat < WhopSDK::Internal::Type::BaseModel
       # @!attribute id
-      #   The unique identifier for the AI chat
+      #   The unique identifier for the ai chat.
       #
       #   @return [String]
       required :id, String
 
       # @!attribute blended_token_usage
-      #   The total number of tokens used in the chat
+      #   The total number of tokens consumed across all messages in this conversation.
       #
       #   @return [String]
       required :blended_token_usage, String
 
       # @!attribute created_at
-      #   When the AI chat was created
+      #   The datetime the ai chat was created.
       #
       #   @return [Time]
       required :created_at, Time
 
       # @!attribute last_message_at
-      #   When the last message was sent
+      #   The timestamp of the most recent message in this conversation. Null if no
+      #   messages have been sent yet.
       #
       #   @return [Time, nil]
       required :last_message_at, Time, nil?: true
 
       # @!attribute message_count
-      #   The number of messages in the chat
+      #   The total number of messages exchanged in this conversation.
       #
       #   @return [Integer]
       required :message_count, Integer
 
       # @!attribute title
-      #   The title of the AI chat
+      #   A short descriptive title for this AI chat conversation. Null if no title has
+      #   been set.
       #
       #   @return [String, nil]
       required :title, String, nil?: true
 
       # @!attribute updated_at
-      #   When the AI chat was last updated
+      #   The datetime the ai chat was last updated.
       #
       #   @return [Time]
       required :updated_at, Time
 
       # @!attribute user
-      #   The user who owns the AI chat
+      #   The user who owns this AI chat conversation.
       #
       #   @return [WhopSDK::Models::AIChat::User]
       required :user, -> { WhopSDK::AIChat::User }
 
       # @!method initialize(id:, blended_token_usage:, created_at:, last_message_at:, message_count:, title:, updated_at:, user:)
-      #   An AI chat conversation belonging to a user
+      #   Some parameter documentations has been truncated, see {WhopSDK::Models::AIChat}
+      #   for more details.
       #
-      #   @param id [String] The unique identifier for the AI chat
+      #   An AI-powered chat conversation belonging to a user, with optional scheduled
+      #   automation.
       #
-      #   @param blended_token_usage [String] The total number of tokens used in the chat
+      #   @param id [String] The unique identifier for the ai chat.
       #
-      #   @param created_at [Time] When the AI chat was created
+      #   @param blended_token_usage [String] The total number of tokens consumed across all messages in this conversation.
       #
-      #   @param last_message_at [Time, nil] When the last message was sent
+      #   @param created_at [Time] The datetime the ai chat was created.
       #
-      #   @param message_count [Integer] The number of messages in the chat
+      #   @param last_message_at [Time, nil] The timestamp of the most recent message in this conversation. Null if no messag
       #
-      #   @param title [String, nil] The title of the AI chat
+      #   @param message_count [Integer] The total number of messages exchanged in this conversation.
       #
-      #   @param updated_at [Time] When the AI chat was last updated
+      #   @param title [String, nil] A short descriptive title for this AI chat conversation. Null if no title has be
       #
-      #   @param user [WhopSDK::Models::AIChat::User] The user who owns the AI chat
+      #   @param updated_at [Time] The datetime the ai chat was last updated.
+      #
+      #   @param user [WhopSDK::Models::AIChat::User] The user who owns this AI chat conversation.
 
       # @see WhopSDK::Models::AIChat#user
       class User < WhopSDK::Internal::Type::BaseModel
         # @!attribute id
-        #   The internal ID of the user.
+        #   The unique identifier for the user.
         #
         #   @return [String]
         required :id, String
 
         # @!method initialize(id:)
-        #   The user who owns the AI chat
+        #   The user who owns this AI chat conversation.
         #
-        #   @param id [String] The internal ID of the user.
+        #   @param id [String] The unique identifier for the user.
       end
     end
   end

data/lib/whop_sdk/models/ai_chat_create_params.rb

@@ -7,16 +7,80 @@ module WhopSDK
       extend WhopSDK::Internal::Type::RequestParameters::Converter
       include WhopSDK::Internal::Type::RequestParameters
 
+      # @!attribute message_text
+      #   The text content of the first message to send to the AI agent.
+      #
+      #   @return [String]
+      required :message_text, String
+
+      # @!attribute current_company_id
+      #   The unique identifier of the company to set as context for the AI chat (e.g.,
+      #   "biz_XXXXX").
+      #
+      #   @return [String, nil]
+      optional :current_company_id, String, nil?: true
+
+      # @!attribute message_attachments
+      #   A list of previously uploaded file attachments to include with the first
+      #   message.
+      #
+      #   @return [Array<WhopSDK::Models::AIChatCreateParams::MessageAttachment>, nil]
+      optional :message_attachments,
+               -> { WhopSDK::Internal::Type::ArrayOf[WhopSDK::AIChatCreateParams::MessageAttachment] },
+               nil?: true
+
+      # @!attribute message_source
+      #   The source of an AI chat message
+      #
+      #   @return [Symbol, WhopSDK::Models::AIChatCreateParams::MessageSource, nil]
+      optional :message_source, enum: -> { WhopSDK::AIChatCreateParams::MessageSource }, nil?: true
+
       # @!attribute title
-      #   The title of the AI chat
+      #   An optional display title for the AI chat thread (e.g., "Help with billing").
       #
       #   @return [String, nil]
       optional :title, String, nil?: true
 
-      # @!method initialize(title: nil, request_options: {})
-      #   @param title [String, nil] The title of the AI chat
+      # @!method initialize(message_text:, current_company_id: nil, message_attachments: nil, message_source: nil, title: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::AIChatCreateParams} for more details.
+      #
+      #   @param message_text [String] The text content of the first message to send to the AI agent.
+      #
+      #   @param current_company_id [String, nil] The unique identifier of the company to set as context for the AI chat (e.g., "b
+      #
+      #   @param message_attachments [Array<WhopSDK::Models::AIChatCreateParams::MessageAttachment>, nil] A list of previously uploaded file attachments to include with the first message
+      #
+      #   @param message_source [Symbol, WhopSDK::Models::AIChatCreateParams::MessageSource, nil] The source of an AI chat message
+      #
+      #   @param title [String, nil] An optional display title for the AI chat thread (e.g., "Help with billing").
       #
       #   @param request_options [WhopSDK::RequestOptions, Hash{Symbol=>Object}]
+
+      class MessageAttachment < WhopSDK::Internal::Type::BaseModel
+        # @!attribute id
+        #   The ID of an existing file object.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   Input for an attachment
+        #
+        #   @param id [String] The ID of an existing file object.
+      end
+
+      # The source of an AI chat message
+      module MessageSource
+        extend WhopSDK::Internal::Type::Enum
+
+        MANUAL = :manual
+        SUGGESTION = :suggestion
+        LINK = :link
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/whop_sdk/models/ai_chat_list_response.rb

@@ -5,84 +5,90 @@ module WhopSDK
     # @see WhopSDK::Resources::AIChats#list
     class AIChatListResponse < WhopSDK::Internal::Type::BaseModel
       # @!attribute id
-      #   The unique identifier for the AI chat
+      #   The unique identifier for the ai chat.
       #
       #   @return [String]
       required :id, String
 
       # @!attribute blended_token_usage
-      #   The total number of tokens used in the chat
+      #   The total number of tokens consumed across all messages in this conversation.
       #
       #   @return [String]
       required :blended_token_usage, String
 
       # @!attribute created_at
-      #   When the AI chat was created
+      #   The datetime the ai chat was created.
       #
       #   @return [Time]
       required :created_at, Time
 
       # @!attribute last_message_at
-      #   When the last message was sent
+      #   The timestamp of the most recent message in this conversation. Null if no
+      #   messages have been sent yet.
       #
       #   @return [Time, nil]
       required :last_message_at, Time, nil?: true
 
       # @!attribute message_count
-      #   The number of messages in the chat
+      #   The total number of messages exchanged in this conversation.
       #
       #   @return [Integer]
       required :message_count, Integer
 
       # @!attribute title
-      #   The title of the AI chat
+      #   A short descriptive title for this AI chat conversation. Null if no title has
+      #   been set.
       #
       #   @return [String, nil]
       required :title, String, nil?: true
 
       # @!attribute updated_at
-      #   When the AI chat was last updated
+      #   The datetime the ai chat was last updated.
       #
       #   @return [Time]
       required :updated_at, Time
 
       # @!attribute user
-      #   The user who owns the AI chat
+      #   The user who owns this AI chat conversation.
       #
       #   @return [WhopSDK::Models::AIChatListResponse::User]
       required :user, -> { WhopSDK::Models::AIChatListResponse::User }
 
       # @!method initialize(id:, blended_token_usage:, created_at:, last_message_at:, message_count:, title:, updated_at:, user:)
-      #   An AI chat conversation belonging to a user
+      #   Some parameter documentations has been truncated, see
+      #   {WhopSDK::Models::AIChatListResponse} for more details.
       #
-      #   @param id [String] The unique identifier for the AI chat
+      #   An AI-powered chat conversation belonging to a user, with optional scheduled
+      #   automation.
       #
-      #   @param blended_token_usage [String] The total number of tokens used in the chat
+      #   @param id [String] The unique identifier for the ai chat.
       #
-      #   @param created_at [Time] When the AI chat was created
+      #   @param blended_token_usage [String] The total number of tokens consumed across all messages in this conversation.
       #
-      #   @param last_message_at [Time, nil] When the last message was sent
+      #   @param created_at [Time] The datetime the ai chat was created.
       #
-      #   @param message_count [Integer] The number of messages in the chat
+      #   @param last_message_at [Time, nil] The timestamp of the most recent message in this conversation. Null if no messag
       #
-      #   @param title [String, nil] The title of the AI chat
+      #   @param message_count [Integer] The total number of messages exchanged in this conversation.
       #
-      #   @param updated_at [Time] When the AI chat was last updated
+      #   @param title [String, nil] A short descriptive title for this AI chat conversation. Null if no title has be
       #
-      #   @param user [WhopSDK::Models::AIChatListResponse::User] The user who owns the AI chat
+      #   @param updated_at [Time] The datetime the ai chat was last updated.
+      #
+      #   @param user [WhopSDK::Models::AIChatListResponse::User] The user who owns this AI chat conversation.
 
       # @see WhopSDK::Models::AIChatListResponse#user
       class User < WhopSDK::Internal::Type::BaseModel
         # @!attribute id
-        #   The internal ID of the user.
+        #   The unique identifier for the user.
         #
         #   @return [String]
         required :id, String
 
         # @!method initialize(id:)
-        #   The user who owns the AI chat
+        #   The user who owns this AI chat conversation.
         #
-        #   @param id [String] The internal ID of the user.
+        #   @param id [String] The unique identifier for the user.
       end
     end
   end