openai 0.86.0 → 0.88.0

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

@@ -41,16 +41,31 @@ module OpenAI
         required :type, const: :allowed_tools
 
         # @!method initialize(mode:, tools:, type: :allowed_tools)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ToolChoiceAllowed} for more details.
-        #
         #   Constrains the tools available to the model to a pre-defined set.
         #
-        #   @param mode [Symbol, OpenAI::Models::Responses::ToolChoiceAllowed::Mode] Constrains the tools available to the model to a pre-defined set.
+        #   @param mode [Symbol, OpenAI::Models::Responses::ToolChoiceAllowed::Mode]
+        #     Constrains the tools available to the model to a pre-defined set.
+        #
+        #     `auto` allows the model to pick from among the allowed tools and generate a
+        #     message.
+        #
+        #     `required` requires the model to call one or more of the allowed tools.
+        #
+        #   @param tools [Array<Hash{Symbol=>Object}>]
+        #     A list of tool definitions that the model should be allowed to call.
+        #
+        #     For the Responses API, the list of tool definitions might look like:
         #
-        #   @param tools [Array<Hash{Symbol=>Object}>] A list of tool definitions that the model should be allowed to call.
+        #     ```json
+        #     [
+        #       { "type": "function", "name": "get_weather" },
+        #       { "type": "mcp", "server_label": "deepwiki" },
+        #       { "type": "image_generation" }
+        #     ]
+        #     ```
         #
-        #   @param type [Symbol, :allowed_tools] Allowed tool configuration type. Always `allowed_tools`.
+        #   @param type [Symbol, :allowed_tools]
+        #     Allowed tool configuration type. Always `allowed_tools`.
 
         # Constrains the tools available to the model to a pre-defined set.
         #

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

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(type: :apply_patch)
         #   Forces the model to call the apply_patch tool when executing a tool call.
         #
-        #   @param type [Symbol, :apply_patch] The tool to call. Always `apply_patch`.
+        #   @param type [Symbol, :apply_patch]
+        #     The tool to call. Always `apply_patch`.
       end
     end
   end

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

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(name:, type: :custom)
         #   Use this option to force the model to call a specific custom tool.
         #
-        #   @param name [String] The name of the custom tool to call.
+        #   @param name [String]
+        #     The name of the custom tool to call.
         #
-        #   @param type [Symbol, :custom] For custom tool calling, the type is always `custom`.
+        #   @param type [Symbol, :custom]
+        #     For custom tool calling, the type is always `custom`.
       end
     end
   end

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

@@ -19,9 +19,11 @@ module OpenAI
         # @!method initialize(name:, type: :function)
         #   Use this option to force the model to call a specific function.
         #
-        #   @param name [String] The name of the function to call.
+        #   @param name [String]
+        #     The name of the function to call.
         #
-        #   @param type [Symbol, :function] For function calling, the type is always `function`.
+        #   @param type [Symbol, :function]
+        #     For function calling, the type is always `function`.
       end
     end
   end

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

@@ -23,17 +23,17 @@ module OpenAI
         optional :name, String, nil?: true
 
         # @!method initialize(server_label:, name: nil, type: :mcp)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ToolChoiceMcp} for more details.
-        #
         #   Use this option to force the model to call a specific tool on a remote MCP
         #   server.
         #
-        #   @param server_label [String] The label of the MCP server to use.
+        #   @param server_label [String]
+        #     The label of the MCP server to use.
         #
-        #   @param name [String, nil] The name of the tool to call on the server.
+        #   @param name [String, nil]
+        #     The name of the tool to call on the server.
         #
-        #   @param type [Symbol, :mcp] For MCP tools, the type is always `mcp`.
+        #   @param type [Symbol, :mcp]
+        #     For MCP tools, the type is always `mcp`.
       end
     end
   end

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

@@ -13,7 +13,8 @@ module OpenAI
         # @!method initialize(type: :shell)
         #   Forces the model to call the shell tool when a tool call is required.
         #
-        #   @param type [Symbol, :shell] The tool to call. Always `shell`.
+        #   @param type [Symbol, :shell]
+        #     The tool to call. Always `shell`.
       end
     end
   end

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

@@ -6,7 +6,7 @@ module OpenAI
       class ToolChoiceTypes < OpenAI::Internal::Type::BaseModel
         # @!attribute type
         #   The type of hosted tool the model should to use. Learn more about
-        #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+        #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
         #
         #   Allowed values are:
         #
@@ -22,16 +22,25 @@ module OpenAI
         required :type, enum: -> { OpenAI::Responses::ToolChoiceTypes::Type }
 
         # @!method initialize(type:)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ToolChoiceTypes} for more details.
-        #
         #   Indicates that the model should use a built-in tool to generate a response.
-        #   [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+        #   [Learn more about built-in tools](https://developers.openai.com/api/docs/guides/tools).
+        #
+        #   @param type [Symbol, OpenAI::Models::Responses::ToolChoiceTypes::Type]
+        #     The type of hosted tool the model should to use. Learn more about
+        #     [built-in tools](https://developers.openai.com/api/docs/guides/tools).
+        #
+        #     Allowed values are:
         #
-        #   @param type [Symbol, OpenAI::Models::Responses::ToolChoiceTypes::Type] The type of hosted tool the model should to use. Learn more about
+        #     - `file_search`
+        #     - `web_search_preview`
+        #     - `computer`
+        #     - `computer_use_preview`
+        #     - `computer_use`
+        #     - `code_interpreter`
+        #     - `image_generation`
 
         # The type of hosted tool the model should to use. Learn more about
-        # [built-in tools](https://platform.openai.com/docs/guides/tools).
+        # [built-in tools](https://developers.openai.com/api/docs/guides/tools).
         #
         # Allowed values are:
         #

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

@@ -31,13 +31,17 @@ module OpenAI
         # @!method initialize(description: nil, execution: nil, parameters: nil, type: :tool_search)
         #   Hosted or BYOT tool search configuration for deferred tools.
         #
-        #   @param description [String, nil] Description shown to the model for a client-executed tool search tool.
+        #   @param description [String, nil]
+        #     Description shown to the model for a client-executed tool search tool.
         #
-        #   @param execution [Symbol, OpenAI::Models::Responses::ToolSearchTool::Execution] Whether tool search is executed by the server or by the client.
+        #   @param execution [Symbol, OpenAI::Models::Responses::ToolSearchTool::Execution]
+        #     Whether tool search is executed by the server or by the client.
         #
-        #   @param parameters [Object, nil] Parameter schema for a client-executed tool search tool.
+        #   @param parameters [Object, nil]
+        #     Parameter schema for a client-executed tool search tool.
         #
-        #   @param type [Symbol, :tool_search] The type of the tool. Always `tool_search`.
+        #   @param type [Symbol, :tool_search]
+        #     The type of the tool. Always `tool_search`.
 
         # Whether tool search is executed by the server or by the client.
         #

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