openai 0.87.0 → 0.89.0

data/lib/openai/models/responses/web_search_preview_tool.rb

@@ -33,20 +33,22 @@ module OpenAI
         optional :user_location, -> { OpenAI::Responses::WebSearchPreviewTool::UserLocation }, nil?: true
 
         # @!method initialize(type:, search_content_types: nil, search_context_size: nil, user_location: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::WebSearchPreviewTool} for more details.
-        #
         #   This tool searches the web for relevant results to use in a response. Learn more
         #   about the
-        #   [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+        #   [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
         #
-        #   @param type [Symbol, OpenAI::Models::Responses::WebSearchPreviewTool::Type] The type of the web search tool. One of `web_search_preview` or `web_search_prev
+        #   @param type [Symbol, OpenAI::Models::Responses::WebSearchPreviewTool::Type]
+        #     The type of the web search tool. One of `web_search_preview` or
+        #     `web_search_preview_2025_03_11`.
         #
         #   @param search_content_types [Array<Symbol, OpenAI::Models::Responses::WebSearchPreviewTool::SearchContentType>]
         #
-        #   @param search_context_size [Symbol, OpenAI::Models::Responses::WebSearchPreviewTool::SearchContextSize] High level guidance for the amount of context window space to use for the search
+        #   @param search_context_size [Symbol, OpenAI::Models::Responses::WebSearchPreviewTool::SearchContextSize]
+        #     High level guidance for the amount of context window space to use for the
+        #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
-        #   @param user_location [OpenAI::Models::Responses::WebSearchPreviewTool::UserLocation, nil] The user's location.
+        #   @param user_location [OpenAI::Models::Responses::WebSearchPreviewTool::UserLocation, nil]
+        #     The user's location.
 
         # The type of the web search tool. One of `web_search_preview` or
         # `web_search_preview_2025_03_11`.
@@ -122,21 +124,24 @@ module OpenAI
           optional :timezone, String, nil?: true
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::WebSearchPreviewTool::UserLocation} for more
-          #   details.
-          #
           #   The user's location.
           #
-          #   @param city [String, nil] Free text input for the city of the user, e.g. `San Francisco`.
+          #   @param city [String, nil]
+          #     Free text input for the city of the user, e.g. `San Francisco`.
           #
-          #   @param country [String, nil] The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of t
+          #   @param country [String, nil]
+          #     The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #     the user, e.g. `US`.
           #
-          #   @param region [String, nil] Free text input for the region of the user, e.g. `California`.
+          #   @param region [String, nil]
+          #     Free text input for the region of the user, e.g. `California`.
           #
-          #   @param timezone [String, nil] The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user
+          #   @param timezone [String, nil]
+          #     The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #     user, e.g. `America/Los_Angeles`.
           #
-          #   @param type [Symbol, :approximate] The type of location approximation. Always `approximate`.
+          #   @param type [Symbol, :approximate]
+          #     The type of location approximation. Always `approximate`.
         end
       end
     end

data/lib/openai/models/responses/web_search_tool.rb

@@ -38,21 +38,26 @@ module OpenAI
         optional :user_location, -> { OpenAI::Responses::WebSearchTool::UserLocation }, nil?: true
 
         # @!method initialize(type:, external_web_access: nil, filters: nil, search_context_size: nil, user_location: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::WebSearchTool} for more details.
-        #
         #   Search the Internet for sources related to the prompt. Learn more about the
-        #   [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+        #   [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
         #
-        #   @param type [Symbol, OpenAI::Models::Responses::WebSearchTool::Type] The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+        #   @param type [Symbol, OpenAI::Models::Responses::WebSearchTool::Type]
+        #     The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
-        #   @param external_web_access [Boolean] Allow live internet access for web search. Defaults to true when omitted. When f
+        #   @param external_web_access [Boolean]
+        #     Allow live internet access for web search. Defaults to true when omitted. When
+        #     false, the web search tool runs in offline/cache-only mode and will not fetch
+        #     new external content.
         #
-        #   @param filters [OpenAI::Models::Responses::WebSearchTool::Filters, nil] Filters for the search.
+        #   @param filters [OpenAI::Models::Responses::WebSearchTool::Filters, nil]
+        #     Filters for the search.
         #
-        #   @param search_context_size [Symbol, OpenAI::Models::Responses::WebSearchTool::SearchContextSize] High level guidance for the amount of context window space to use for the search
+        #   @param search_context_size [Symbol, OpenAI::Models::Responses::WebSearchTool::SearchContextSize]
+        #     High level guidance for the amount of context window space to use for the
+        #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
-        #   @param user_location [OpenAI::Models::Responses::WebSearchTool::UserLocation, nil] The approximate location of the user.
+        #   @param user_location [OpenAI::Models::Responses::WebSearchTool::UserLocation, nil]
+        #     The approximate location of the user.
 
         # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
@@ -79,12 +84,13 @@ module OpenAI
           optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
           # @!method initialize(allowed_domains: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::WebSearchTool::Filters} for more details.
-          #
           #   Filters for the search.
           #
-          #   @param allowed_domains [Array<String>, nil] Allowed domains for the search. If not provided, all domains are allowed.
+          #   @param allowed_domains [Array<String>, nil]
+          #     Allowed domains for the search. If not provided, all domains are allowed.
+          #     Subdomains of the provided domains are allowed as well.
+          #
+          #     Example: `["pubmed.ncbi.nlm.nih.gov"]`
         end
 
         # High level guidance for the amount of context window space to use for the
@@ -137,20 +143,24 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Responses::WebSearchTool::UserLocation::Type }
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::WebSearchTool::UserLocation} for more details.
-          #
           #   The approximate location of the user.
           #
-          #   @param city [String, nil] Free text input for the city of the user, e.g. `San Francisco`.
+          #   @param city [String, nil]
+          #     Free text input for the city of the user, e.g. `San Francisco`.
           #
-          #   @param country [String, nil] The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of t
+          #   @param country [String, nil]
+          #     The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+          #     the user, e.g. `US`.
           #
-          #   @param region [String, nil] Free text input for the region of the user, e.g. `California`.
+          #   @param region [String, nil]
+          #     Free text input for the region of the user, e.g. `California`.
           #
-          #   @param timezone [String, nil] The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user
+          #   @param timezone [String, nil]
+          #     The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+          #     user, e.g. `America/Los_Angeles`.
           #
-          #   @param type [Symbol, OpenAI::Models::Responses::WebSearchTool::UserLocation::Type] The type of location approximation. Always `approximate`.
+          #   @param type [Symbol, OpenAI::Models::Responses::WebSearchTool::UserLocation::Type]
+          #     The type of location approximation. Always `approximate`.
 
           # The type of location approximation. Always `approximate`.
           #

data/lib/openai/models/safety/alert_retrieve_params.rb

@@ -15,7 +15,8 @@ module OpenAI
         required :id, String
 
         # @!method initialize(id:, request_options: {})
-        #   @param id [String] Project safety alert ID
+        #   @param id [String]
+        #     Project safety alert ID
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/safety/safety_alert.rb

@@ -55,9 +55,6 @@ module OpenAI
         required :response_id, String
 
         # @!method initialize(id:, created_at:, error_type:, model:, reason:, request_id:, request_paused:, response_id:, object: :"safety.alert")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Safety::SafetyAlert} for more details.
-        #
         #   @param id [String]
         #
         #   @param created_at [Integer]
@@ -66,11 +63,15 @@ module OpenAI
         #
         #   @param model [String]
         #
-        #   @param reason [String, nil] A customer-safe description derived from error_type, or null for zero data reten
+        #   @param reason [String, nil]
+        #     A customer-safe description derived from error_type, or null for zero data
+        #     retention requests.
         #
         #   @param request_id [String]
         #
-        #   @param request_paused [Boolean] Whether block registration succeeded for this request. This does not confirm tha
+        #   @param request_paused [Boolean]
+        #     Whether block registration succeeded for this request. This does not confirm
+        #     that response execution stopped.
         #
         #   @param response_id [String]
         #

data/lib/openai/models/skill.rb

@@ -47,19 +47,26 @@ module OpenAI
       required :object, const: :skill
 
       # @!method initialize(id:, created_at:, default_version:, description:, latest_version:, name:, object: :skill)
-      #   @param id [String] Unique identifier for the skill.
+      #   @param id [String]
+      #     Unique identifier for the skill.
       #
-      #   @param created_at [Integer] Unix timestamp (seconds) for when the skill was created.
+      #   @param created_at [Integer]
+      #     Unix timestamp (seconds) for when the skill was created.
       #
-      #   @param default_version [String] Default version for the skill.
+      #   @param default_version [String]
+      #     Default version for the skill.
       #
-      #   @param description [String] Description of the skill.
+      #   @param description [String]
+      #     Description of the skill.
       #
-      #   @param latest_version [String] Latest version for the skill.
+      #   @param latest_version [String]
+      #     Latest version for the skill.
       #
-      #   @param name [String] Name of the skill.
+      #   @param name [String]
+      #     Name of the skill.
       #
-      #   @param object [Symbol, :skill] The object type, which is `skill`.
+      #   @param object [Symbol, :skill]
+      #     The object type, which is `skill`.
     end
   end
 end

data/lib/openai/models/skill_create_params.rb

@@ -18,7 +18,12 @@ module OpenAI
       optional :files, union: -> { OpenAI::SkillCreateParams::Files }
 
       # @!method initialize(files: nil, request_options: {})
-      #   @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart] Skill files to upload (directory upload) or a single zip file.
+      #   @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #     Skill files to upload (directory upload) or a single zip file.
+      #
+      #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #     content type.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/skill_list.rb

@@ -34,15 +34,20 @@ module OpenAI
       required :object, const: :list
 
       # @!method initialize(data:, first_id:, has_more:, last_id:, object: :list)
-      #   @param data [Array<OpenAI::Models::Skill>] A list of items
+      #   @param data [Array<OpenAI::Models::Skill>]
+      #     A list of items
       #
-      #   @param first_id [String, nil] The ID of the first item in the list.
+      #   @param first_id [String, nil]
+      #     The ID of the first item in the list.
       #
-      #   @param has_more [Boolean] Whether there are more items available.
+      #   @param has_more [Boolean]
+      #     Whether there are more items available.
       #
-      #   @param last_id [String, nil] The ID of the last item in the list.
+      #   @param last_id [String, nil]
+      #     The ID of the last item in the list.
       #
-      #   @param object [Symbol, :list] The type of object returned, must be `list`.
+      #   @param object [Symbol, :list]
+      #     The type of object returned, must be `list`.
     end
   end
 end

data/lib/openai/models/skill_list_params.rb

@@ -27,14 +27,15 @@ module OpenAI
       optional :order, enum: -> { OpenAI::SkillListParams::Order }
 
       # @!method initialize(after: nil, limit: nil, order: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::SkillListParams} for more details.
+      #   @param after [String]
+      #     Identifier for the last item from the previous pagination request
       #
-      #   @param after [String] Identifier for the last item from the previous pagination request
+      #   @param limit [Integer]
+      #     Number of items to retrieve
       #
-      #   @param limit [Integer] Number of items to retrieve
-      #
-      #   @param order [Symbol, OpenAI::Models::SkillListParams::Order] Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      #   @param order [Symbol, OpenAI::Models::SkillListParams::Order]
+      #     Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      #     descending order.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/skill_update_params.rb

@@ -21,7 +21,8 @@ module OpenAI
       # @!method initialize(skill_id:, default_version:, request_options: {})
       #   @param skill_id [String]
       #
-      #   @param default_version [String] The skill version number to set as default.
+      #   @param default_version [String]
+      #     The skill version number to set as default.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/openai/models/skills/deleted_skill_version.rb

@@ -31,7 +31,8 @@ module OpenAI
         #
         #   @param deleted [Boolean]
         #
-        #   @param version [String] The deleted skill version.
+        #   @param version [String]
+        #     The deleted skill version.
         #
         #   @param object [Symbol, :"skill.version.deleted"]
       end

data/lib/openai/models/skills/skill_version.rb

@@ -48,19 +48,26 @@ module OpenAI
         required :version, String
 
         # @!method initialize(id:, created_at:, description:, name:, skill_id:, version:, object: :"skill.version")
-        #   @param id [String] Unique identifier for the skill version.
+        #   @param id [String]
+        #     Unique identifier for the skill version.
         #
-        #   @param created_at [Integer] Unix timestamp (seconds) for when the version was created.
+        #   @param created_at [Integer]
+        #     Unix timestamp (seconds) for when the version was created.
         #
-        #   @param description [String] Description of the skill version.
+        #   @param description [String]
+        #     Description of the skill version.
         #
-        #   @param name [String] Name of the skill version.
+        #   @param name [String]
+        #     Name of the skill version.
         #
-        #   @param skill_id [String] Identifier of the skill for this version.
+        #   @param skill_id [String]
+        #     Identifier of the skill for this version.
         #
-        #   @param version [String] Version number for this skill.
+        #   @param version [String]
+        #     Version number for this skill.
         #
-        #   @param object [Symbol, :"skill.version"] The object type, which is `skill.version`.
+        #   @param object [Symbol, :"skill.version"]
+        #     The object type, which is `skill.version`.
       end
     end
 

data/lib/openai/models/skills/skill_version_list.rb

@@ -35,15 +35,20 @@ module OpenAI
         required :object, const: :list
 
         # @!method initialize(data:, first_id:, has_more:, last_id:, object: :list)
-        #   @param data [Array<OpenAI::Models::Skills::SkillVersion>] A list of items
+        #   @param data [Array<OpenAI::Models::Skills::SkillVersion>]
+        #     A list of items
         #
-        #   @param first_id [String, nil] The ID of the first item in the list.
+        #   @param first_id [String, nil]
+        #     The ID of the first item in the list.
         #
-        #   @param has_more [Boolean] Whether there are more items available.
+        #   @param has_more [Boolean]
+        #     Whether there are more items available.
         #
-        #   @param last_id [String, nil] The ID of the last item in the list.
+        #   @param last_id [String, nil]
+        #     The ID of the last item in the list.
         #
-        #   @param object [Symbol, :list] The type of object returned, must be `list`.
+        #   @param object [Symbol, :list]
+        #     The type of object returned, must be `list`.
       end
     end
 

data/lib/openai/models/skills/version_create_params.rb

@@ -32,9 +32,15 @@ module OpenAI
         # @!method initialize(skill_id:, default: nil, files: nil, request_options: {})
         #   @param skill_id [String]
         #
-        #   @param default [Boolean] Whether to set this version as the default.
+        #   @param default [Boolean]
+        #     Whether to set this version as the default.
         #
-        #   @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart] Skill files to upload (directory upload) or a single zip file.
+        #   @param files [Array<Pathname, StringIO, IO, String, OpenAI::FilePart>, Pathname, StringIO, IO, String, OpenAI::FilePart]
+        #     Skill files to upload (directory upload) or a single zip file.
+        #
+        #     `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+        #     metadata. Use `OpenAI::FilePart` when you need to override the filename or
+        #     content type.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/skills/version_delete_params.rb

@@ -22,7 +22,8 @@ module OpenAI
         # @!method initialize(skill_id:, version:, request_options: {})
         #   @param skill_id [String]
         #
-        #   @param version [String] The skill version number.
+        #   @param version [String]
+        #     The skill version number.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/skills/version_list_params.rb

@@ -34,11 +34,14 @@ module OpenAI
         # @!method initialize(skill_id:, after: nil, limit: nil, order: nil, request_options: {})
         #   @param skill_id [String]
         #
-        #   @param after [String] The skill version ID to start after.
+        #   @param after [String]
+        #     The skill version ID to start after.
         #
-        #   @param limit [Integer] Number of versions to retrieve.
+        #   @param limit [Integer]
+        #     Number of versions to retrieve.
         #
-        #   @param order [Symbol, OpenAI::Models::Skills::VersionListParams::Order] Sort order of results by version number.
+        #   @param order [Symbol, OpenAI::Models::Skills::VersionListParams::Order]
+        #     Sort order of results by version number.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/skills/version_retrieve_params.rb

@@ -22,7 +22,8 @@ module OpenAI
         # @!method initialize(skill_id:, version:, request_options: {})
         #   @param skill_id [String]
         #
-        #   @param version [String] The version number to retrieve.
+        #   @param version [String]
+        #     The version number to retrieve.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end

data/lib/openai/models/skills/versions/content_retrieve_params.rb

@@ -23,7 +23,8 @@ module OpenAI
           # @!method initialize(skill_id:, version:, request_options: {})
           #   @param skill_id [String]
           #
-          #   @param version [String] The skill version number.
+          #   @param version [String]
+          #     The skill version number.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
         end

data/lib/openai/models/static_file_chunking_strategy.rb

@@ -19,12 +19,14 @@ module OpenAI
       required :max_chunk_size_tokens, Integer
 
       # @!method initialize(chunk_overlap_tokens:, max_chunk_size_tokens:)
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::StaticFileChunkingStrategy} for more details.
+      #   @param chunk_overlap_tokens [Integer]
+      #     The number of tokens that overlap between chunks. The default value is `400`.
       #
-      #   @param chunk_overlap_tokens [Integer] The number of tokens that overlap between chunks. The default value is `400`.
+      #     Note that the overlap must not exceed half of `max_chunk_size_tokens`.
       #
-      #   @param max_chunk_size_tokens [Integer] The maximum number of tokens in each chunk. The default value is `800`. The mini
+      #   @param max_chunk_size_tokens [Integer]
+      #     The maximum number of tokens in each chunk. The default value is `800`. The
+      #     minimum value is `100` and the maximum value is `4096`.
     end
   end
 end

data/lib/openai/models/static_file_chunking_strategy_object.rb

@@ -17,7 +17,8 @@ module OpenAI
       # @!method initialize(static:, type: :static)
       #   @param static [OpenAI::Models::StaticFileChunkingStrategy]
       #
-      #   @param type [Symbol, :static] Always `static`.
+      #   @param type [Symbol, :static]
+      #     Always `static`.
     end
   end
 end

data/lib/openai/models/static_file_chunking_strategy_object_param.rb

@@ -19,7 +19,8 @@ module OpenAI
       #
       #   @param static [OpenAI::Models::StaticFileChunkingStrategy]
       #
-      #   @param type [Symbol, :static] Always `static`.
+      #   @param type [Symbol, :static]
+      #     Always `static`.
     end
   end
 end

data/lib/openai/models/upload.rb

@@ -42,7 +42,7 @@ module OpenAI
 
       # @!attribute purpose
       #   The intended purpose of the file.
-      #   [Please refer here](https://platform.openai.com/docs/api-reference/files/object#files/object-purpose)
+      #   [Please refer here](https://developers.openai.com/api/reference/resources/files#%28resource%29%20files%20%3E%20%28model%29%20file_object%20%3E%20%28schema%29%20%3E%20%28property%29%20purpose)
       #   for acceptable values.
       #
       #   @return [String]
@@ -61,28 +61,36 @@ module OpenAI
       optional :file, -> { OpenAI::FileObject }, nil?: true
 
       # @!method initialize(id:, bytes:, created_at:, expires_at:, filename:, purpose:, status:, file: nil, object: :upload)
-      #   Some parameter documentations has been truncated, see {OpenAI::Models::Upload}
-      #   for more details.
-      #
       #   The Upload object can accept byte chunks in the form of Parts.
       #
-      #   @param id [String] The Upload unique identifier, which can be referenced in API endpoints.
+      #   @param id [String]
+      #     The Upload unique identifier, which can be referenced in API endpoints.
       #
-      #   @param bytes [Integer] The intended number of bytes to be uploaded.
+      #   @param bytes [Integer]
+      #     The intended number of bytes to be uploaded.
       #
-      #   @param created_at [Integer] The Unix timestamp (in seconds) for when the Upload was created.
+      #   @param created_at [Integer]
+      #     The Unix timestamp (in seconds) for when the Upload was created.
       #
-      #   @param expires_at [Integer] The Unix timestamp (in seconds) for when the Upload will expire.
+      #   @param expires_at [Integer]
+      #     The Unix timestamp (in seconds) for when the Upload will expire.
       #
-      #   @param filename [String] The name of the file to be uploaded.
+      #   @param filename [String]
+      #     The name of the file to be uploaded.
       #
-      #   @param purpose [String] The intended purpose of the file. [Please refer here](https://platform.openai.co
+      #   @param purpose [String]
+      #     The intended purpose of the file.
+      #     [Please refer here](https://developers.openai.com/api/reference/resources/files#%28resource%29%20files%20%3E%20%28model%29%20file_object%20%3E%20%28schema%29%20%3E%20%28property%29%20purpose)
+      #     for acceptable values.
       #
-      #   @param status [Symbol, OpenAI::Models::Upload::Status] The status of the Upload.
+      #   @param status [Symbol, OpenAI::Models::Upload::Status]
+      #     The status of the Upload.
       #
-      #   @param file [OpenAI::Models::FileObject, nil] The `File` object represents a document that has been uploaded to OpenAI.
+      #   @param file [OpenAI::Models::FileObject, nil]
+      #     The `File` object represents a document that has been uploaded to OpenAI.
       #
-      #   @param object [Symbol, :upload] The object type, which is always "upload".
+      #   @param object [Symbol, :upload]
+      #     The object type, which is always "upload".
 
       # The status of the Upload.
       #

data/lib/openai/models/upload_complete_params.rb

@@ -26,14 +26,14 @@ module OpenAI
       optional :md5, String
 
       # @!method initialize(upload_id:, part_ids:, md5: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::UploadCompleteParams} for more details.
-      #
       #   @param upload_id [String]
       #
-      #   @param part_ids [Array<String>] The ordered list of Part IDs.
+      #   @param part_ids [Array<String>]
+      #     The ordered list of Part IDs.
       #
-      #   @param md5 [String] The optional md5 checksum for the file contents to verify if the bytes uploaded
+      #   @param md5 [String]
+      #     The optional md5 checksum for the file contents to verify if the bytes uploaded
+      #     matches what you expect.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/openai/models/upload_create_params.rb

@@ -32,7 +32,7 @@ module OpenAI
       #   The intended purpose of the uploaded file.
       #
       #   See the
-      #   [documentation on File purposes](https://platform.openai.com/docs/api-reference/files/create#files-create-purpose).
+      #   [documentation on File purposes](https://developers.openai.com/api/reference/resources/files/methods/create#%28resource%29%20files%20%3E%20%28method%29%20create%20%3E%20%28params%29%200%20%3E%20%28param%29%20purpose%20%3E%20%28schema%29).
       #
       #   @return [Symbol, OpenAI::Models::FilePurpose]
       required :purpose, enum: -> { OpenAI::FilePurpose }
@@ -45,18 +45,27 @@ module OpenAI
       optional :expires_after, -> { OpenAI::UploadCreateParams::ExpiresAfter }
 
       # @!method initialize(bytes:, filename:, mime_type:, purpose:, expires_after: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {OpenAI::Models::UploadCreateParams} for more details.
+      #   @param bytes [Integer]
+      #     The number of bytes in the file you are uploading.
       #
-      #   @param bytes [Integer] The number of bytes in the file you are uploading.
+      #   @param filename [String]
+      #     The name of the file to upload.
       #
-      #   @param filename [String] The name of the file to upload.
+      #   @param mime_type [String]
+      #     The MIME type of the file.
       #
-      #   @param mime_type [String] The MIME type of the file.
+      #     This must fall within the supported MIME types for your file purpose. See the
+      #     supported MIME types for assistants and vision.
       #
-      #   @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file.
+      #   @param purpose [Symbol, OpenAI::Models::FilePurpose]
+      #     The intended purpose of the uploaded file.
       #
-      #   @param expires_after [OpenAI::Models::UploadCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
+      #     See the
+      #     [documentation on File purposes](https://developers.openai.com/api/reference/resources/files/methods/create#%28resource%29%20files%20%3E%20%28method%29%20create%20%3E%20%28params%29%200%20%3E%20%28param%29%20purpose%20%3E%20%28schema%29).
+      #
+      #   @param expires_after [OpenAI::Models::UploadCreateParams::ExpiresAfter]
+      #     The expiration policy for a file. By default, files with `purpose=batch` expire
+      #     after 30 days and all other files are persisted until they are manually deleted.
       #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
@@ -76,15 +85,16 @@ module OpenAI
         required :seconds, Integer
 
         # @!method initialize(seconds:, anchor: :created_at)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::UploadCreateParams::ExpiresAfter} for more details.
-        #
         #   The expiration policy for a file. By default, files with `purpose=batch` expire
         #   after 30 days and all other files are persisted until they are manually deleted.
         #
-        #   @param seconds [Integer] The number of seconds after the anchor time that the file will expire. Must be b
+        #   @param seconds [Integer]
+        #     The number of seconds after the anchor time that the file will expire. Must be
+        #     between 3600 (1 hour) and 2592000 (30 days).
         #
-        #   @param anchor [Symbol, :created_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+        #   @param anchor [Symbol, :created_at]
+        #     Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #     `created_at`.
       end
     end
   end