openai 0.86.0 → 0.88.0

data/rbi/openai/models/responses/tool.rbi

@@ -68,7 +68,7 @@ module OpenAI
           # Identifier for service connectors, like those available in ChatGPT. One of
           # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
           # service connectors
-          # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
           # Currently supported `connector_id` values are:
           #
@@ -136,7 +136,7 @@ module OpenAI
 
           # Give the model access to additional tools via remote Model Context Protocol
           # (MCP) servers.
-          # [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+          # [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
           sig do
             params(
 
@@ -192,7 +192,7 @@ module OpenAI
             # Identifier for service connectors, like those available in ChatGPT. One of
             # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
             # service connectors
-            # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+            # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
             #
             # Currently supported `connector_id` values are:
             #
@@ -356,7 +356,7 @@ module OpenAI
           # Identifier for service connectors, like those available in ChatGPT. One of
           # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
           # service connectors
-          # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
           # Currently supported `connector_id` values are:
           #
@@ -954,9 +954,11 @@ module OpenAI
           # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
           # the model will automatically determine the best background for the image.
           #
-          # Transparent backgrounds are available for supported GPT Image models. For
-          # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-          # using `transparent`, set the output format to `png` or `webp`.
+          # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+          # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+          # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+          # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+          # set the output format to `png` or `webp`.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::Background::OrSymbol)) }
           attr_reader :background
 
@@ -979,7 +981,9 @@ module OpenAI
           attr_writer :input_image_mask
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           # `chatgpt-image-latest`. Default: `gpt-image-1`.
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::Tool::ImageGeneration::Model::OrSymbol))) }
           attr_reader :model
@@ -1017,25 +1021,28 @@ module OpenAI
           sig { params(partial_images: Integer).void }
           attr_writer :partial_images
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. The GPT image models support `low`,
+          # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          # `auto`.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol)) }
           attr_reader :quality
 
           sig { params(quality: OpenAI::Responses::Tool::ImageGeneration::Quality::OrSymbol).void }
           attr_writer :quality
 
-          # The size of the generated images. For `gpt-image-2` and
-          # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-          # strings, for example `1536x864`. Width and height must both be divisible by 16
-          # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-          # `2560x1440` are experimental, and the maximum supported resolution is
-          # `3840x2160`. The requested size must also satisfy the model's current pixel and
-          # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-          # supported by the GPT image models; `auto` is supported for models that allow
-          # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-          # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-          # `1024x1792`.
+          # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+          # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+          # Width and height must both be divisible by 16 and the requested aspect ratio
+          # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+          # the maximum supported resolution is `3840x2160`. The requested size must also
+          # satisfy the model's current pixel and edge limits. The standard sizes
+          # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+          # `1024x1024`, `1792x1024`, or `1024x1792`.
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1081,9 +1088,11 @@ module OpenAI
             # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
             # the model will automatically determine the best background for the image.
             #
-            # Transparent backgrounds are available for supported GPT Image models. For
-            # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-            # using `transparent`, set the output format to `png` or `webp`.
+            # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+            # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+            # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+            # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+            # set the output format to `png` or `webp`.
             background: nil,
 
             # Control how much effort the model will exert to match the style and features,
@@ -1097,7 +1106,9 @@ module OpenAI
             input_image_mask: nil,
 
             # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
             # `chatgpt-image-latest`. Default: `gpt-image-1`.
             model: nil,
 
@@ -1115,21 +1126,24 @@ module OpenAI
             # to 3.
             partial_images: nil,
 
-            # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-            # Default: `auto`.
+            # The quality of the generated image. The GPT image models support `low`,
+            # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+            # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+            # `auto`.
             quality: nil,
 
-            # The size of the generated images. For `gpt-image-2` and
-            # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-            # strings, for example `1536x864`. Width and height must both be divisible by 16
-            # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-            # `2560x1440` are experimental, and the maximum supported resolution is
-            # `3840x2160`. The requested size must also satisfy the model's current pixel and
-            # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-            # supported by the GPT image models; `auto` is supported for models that allow
-            # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-            # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-            # `1024x1792`.
+            # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+            # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+            # Width and height must both be divisible by 16 and the requested aspect ratio
+            # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+            # the maximum supported resolution is `3840x2160`. The requested size must also
+            # satisfy the model's current pixel and edge limits. The standard sizes
+            # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+            # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+            # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+            # `1024x1024`, `1792x1024`, or `1024x1792`.
             size: nil,
 
             # The type of the image generation tool. Always `image_generation`.
@@ -1179,9 +1193,11 @@ module OpenAI
           # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
           # the model will automatically determine the best background for the image.
           #
-          # Transparent backgrounds are available for supported GPT Image models. For
-          # `gpt-image-2` and `gpt-image-2-2026-04-21`, this support is in preview. When
-          # using `transparent`, set the output format to `png` or `webp`.
+          # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+          # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+          # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+          # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+          # set the output format to `png` or `webp`.
           module Background
             extend OpenAI::Internal::Type::Enum
 
@@ -1270,7 +1286,9 @@ module OpenAI
           end
 
           # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
-          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`, or
+          # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
           # `chatgpt-image-latest`. Default: `gpt-image-1`.
           module Model
             extend OpenAI::Internal::Type::Union
@@ -1294,6 +1312,22 @@ module OpenAI
               :"gpt-image-2-2026-04-21",
               OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
             )
+            GPT_IMAGE_2_5_SUNBURST = T.let(
+              :"gpt-image-2.5-sunburst",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_SUNBURST_2026_09_08 = T.let(
+              :"gpt-image-2.5-sunburst-2026-09-08",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE = T.let(
+              :"gpt-image-2.5-flare",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
+            GPT_IMAGE_2_5_FLARE_2026_09_08 = T.let(
+              :"gpt-image-2.5-flare-2026-09-08",
+              OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol
+            )
             GPT_IMAGE_1_5 = T.let(:"gpt-image-1.5", OpenAI::Responses::Tool::ImageGeneration::Model::TaggedSymbol)
             CHATGPT_IMAGE_LATEST = T.let(
               :"chatgpt-image-latest",
@@ -1334,8 +1368,10 @@ module OpenAI
             end
           end
 
-          # The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
-          # Default: `auto`.
+          # The quality of the generated image. The GPT image models support `low`,
+          # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+          # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+          # `auto`.
           module Quality
             extend OpenAI::Internal::Type::Enum
 
@@ -1345,6 +1381,8 @@ module OpenAI
             LOW = T.let(:low, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             MEDIUM = T.let(:medium, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             HIGH = T.let(:high, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
+            XHIGH = T.let(:xhigh, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
+            MAX = T.let(:max, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
             AUTO = T.let(:auto, OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol)
 
             sig { override.returns(T::Array[OpenAI::Responses::Tool::ImageGeneration::Quality::TaggedSymbol]) }
@@ -1352,17 +1390,18 @@ module OpenAI
             end
           end
 
-          # The size of the generated images. For `gpt-image-2` and
-          # `gpt-image-2-2026-04-21`, arbitrary resolutions are supported as `WIDTHxHEIGHT`
-          # strings, for example `1536x864`. Width and height must both be divisible by 16
-          # and the requested aspect ratio must be between 1:3 and 3:1. Resolutions above
-          # `2560x1440` are experimental, and the maximum supported resolution is
-          # `3840x2160`. The requested size must also satisfy the model's current pixel and
-          # edge limits. The standard sizes `1024x1024`, `1536x1024`, and `1024x1536` are
-          # supported by the GPT image models; `auto` is supported for models that allow
-          # automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or
-          # `1024x1024`. For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or
-          # `1024x1792`.
+          # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+          # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+          # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+          # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+          # Width and height must both be divisible by 16 and the requested aspect ratio
+          # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+          # the maximum supported resolution is `3840x2160`. The requested size must also
+          # satisfy the model's current pixel and edge limits. The standard sizes
+          # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+          # `1024x1024`, `1792x1024`, or `1024x1792`.
           module Size
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/tool_choice_types.rbi

@@ -15,7 +15,7 @@ module OpenAI
         end
 
         # 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:
         #
@@ -30,7 +30,7 @@ module OpenAI
         attr_accessor :type
 
         # 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).
         sig do
           params(
 
@@ -41,7 +41,7 @@ module OpenAI
         def self.new(
 
           # 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:
           #
@@ -66,7 +66,7 @@ module OpenAI
         end
 
         # 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/rbi/openai/models/responses/web_search_preview_tool.rbi

@@ -45,7 +45,7 @@ module OpenAI
 
         # 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).
         sig do
           params(
 

data/rbi/openai/models/responses/web_search_tool.rbi

@@ -50,7 +50,7 @@ module OpenAI
         attr_writer :user_location
 
         # 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).
         sig do
           params(
 

data/rbi/openai/models/upload.rbi

@@ -37,7 +37,7 @@ module OpenAI
       attr_accessor :object
 
       # 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.
       sig { returns(String) }
       attr_accessor :purpose
@@ -95,7 +95,7 @@ module OpenAI
         filename:,
 
         # 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.
         purpose:,
 

data/rbi/openai/models/upload_create_params.rbi

@@ -33,7 +33,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).
       sig { returns(OpenAI::FilePurpose::OrSymbol) }
       attr_accessor :purpose
 
@@ -79,7 +79,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).
         purpose:,
 
         # The expiration policy for a file. By default, files with `purpose=batch` expire

data/rbi/openai/models/vector_store_create_params.rbi

@@ -48,9 +48,9 @@ module OpenAI
       sig { params(expires_after: OpenAI::VectorStoreCreateParams::ExpiresAfter::OrHash).void }
       attr_writer :expires_after
 
-      # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-      # the vector store should use. Useful for tools like `file_search` that can access
-      # files.
+      # A list of [File](https://developers.openai.com/api/reference/resources/files)
+      # IDs that the vector store should use. Useful for tools like `file_search` that
+      # can access files.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :file_ids
 
@@ -108,9 +108,9 @@ module OpenAI
         # The expiration policy for a vector store.
         expires_after: nil,
 
-        # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-        # the vector store should use. Useful for tools like `file_search` that can access
-        # files.
+        # A list of [File](https://developers.openai.com/api/reference/resources/files)
+        # IDs that the vector store should use. Useful for tools like `file_search` that
+        # can access files.
         file_ids: nil,
 
         # Set of 16 key-value pairs that can be attached to an object. This can be useful

data/rbi/openai/models/vector_stores/file_batch_create_params.rbi

@@ -48,12 +48,12 @@ module OpenAI
         }
         attr_writer :chunking_strategy
 
-        # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-        # the vector store should use. Useful for tools like `file_search` that can access
-        # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-        # to all files in the batch. The maximum batch size is 2000 files. This endpoint
-        # is recommended for multi-file ingestion and helps reduce per-vector-store write
-        # request pressure. Mutually exclusive with `files`.
+        # A list of [File](https://developers.openai.com/api/reference/resources/files)
+        # IDs that the vector store should use. Useful for tools like `file_search` that
+        # can access files. If `attributes` or `chunking_strategy` are provided, they will
+        # be applied to all files in the batch. The maximum batch size is 2000 files. This
+        # endpoint is recommended for multi-file ingestion and helps reduce
+        # per-vector-store write request pressure. Mutually exclusive with `files`.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :file_ids
 
@@ -107,12 +107,12 @@ module OpenAI
           # strategy. Only applicable if `file_ids` is non-empty.
           chunking_strategy: nil,
 
-          # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
-          # the vector store should use. Useful for tools like `file_search` that can access
-          # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-          # to all files in the batch. The maximum batch size is 2000 files. This endpoint
-          # is recommended for multi-file ingestion and helps reduce per-vector-store write
-          # request pressure. Mutually exclusive with `files`.
+          # A list of [File](https://developers.openai.com/api/reference/resources/files)
+          # IDs that the vector store should use. Useful for tools like `file_search` that
+          # can access files. If `attributes` or `chunking_strategy` are provided, they will
+          # be applied to all files in the batch. The maximum batch size is 2000 files. This
+          # endpoint is recommended for multi-file ingestion and helps reduce
+          # per-vector-store write request pressure. Mutually exclusive with `files`.
           file_ids: nil,
 
           # A list of objects that each include a `file_id` plus optional `attributes` or
@@ -164,10 +164,10 @@ module OpenAI
             )
           end
 
-          # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-          # vector store should use. Useful for tools like `file_search` that can access
+          # A [File](https://developers.openai.com/api/reference/resources/files) ID that
+          # the vector store should use. Useful for tools like `file_search` that can access
           # files. For multi-file ingestion, we recommend
-          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
           # to minimize per-vector-store write requests.
           sig { returns(String) }
           attr_accessor :file_id
@@ -220,10 +220,10 @@ module OpenAI
           end
           def self.new(
 
-            # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-            # vector store should use. Useful for tools like `file_search` that can access
+            # A [File](https://developers.openai.com/api/reference/resources/files) ID that
+            # the vector store should use. Useful for tools like `file_search` that can access
             # files. For multi-file ingestion, we recommend
-            # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+            # [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
             # to minimize per-vector-store write requests.
             file_id:,
 

data/rbi/openai/models/vector_stores/file_create_params.rbi

@@ -20,10 +20,10 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :vector_store_id
 
-        # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-        # vector store should use. Useful for tools like `file_search` that can access
+        # A [File](https://developers.openai.com/api/reference/resources/files) ID that
+        # the vector store should use. Useful for tools like `file_search` that can access
         # files. For multi-file ingestion, we recommend
-        # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        # [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
         # to minimize per-vector-store write requests.
         sig { returns(String) }
         attr_accessor :file_id
@@ -78,10 +78,10 @@ module OpenAI
 
           vector_store_id:,
 
-          # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
-          # vector store should use. Useful for tools like `file_search` that can access
+          # A [File](https://developers.openai.com/api/reference/resources/files) ID that
+          # the vector store should use. Useful for tools like `file_search` that can access
           # files. For multi-file ingestion, we recommend
-          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # [`file_batches`](https://developers.openai.com/api/reference/resources/vector_stores/subresources/file_batches/methods/create)
           # to minimize per-vector-store write requests.
           file_id:,
 

data/rbi/openai/models/vector_stores/vector_store_file.rbi

@@ -48,8 +48,8 @@ module OpenAI
         attr_accessor :usage_bytes
 
         # The ID of the
-        # [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-        # that the [File](https://platform.openai.com/docs/api-reference/files) is
+        # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        # that the [File](https://developers.openai.com/api/reference/resources/files) is
         # attached to.
         sig { returns(String) }
         attr_accessor :vector_store_id
@@ -126,8 +126,8 @@ module OpenAI
           usage_bytes:,
 
           # The ID of the
-          # [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-          # that the [File](https://platform.openai.com/docs/api-reference/files) is
+          # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+          # that the [File](https://developers.openai.com/api/reference/resources/files) is
           # attached to.
           vector_store_id:,
 

data/rbi/openai/models/vector_stores/vector_store_file_batch.rbi

@@ -41,8 +41,8 @@ module OpenAI
         attr_accessor :status
 
         # The ID of the
-        # [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-        # that the [File](https://platform.openai.com/docs/api-reference/files) is
+        # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+        # that the [File](https://developers.openai.com/api/reference/resources/files) is
         # attached to.
         sig { returns(String) }
         attr_accessor :vector_store_id
@@ -81,8 +81,8 @@ module OpenAI
           status:,
 
           # The ID of the
-          # [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
-          # that the [File](https://platform.openai.com/docs/api-reference/files) is
+          # [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+          # that the [File](https://developers.openai.com/api/reference/resources/files) is
           # attached to.
           vector_store_id:,
 

data/rbi/openai/models/webhooks/live_call_incoming_webhook_event.rbi

@@ -100,12 +100,14 @@ module OpenAI
             )
           end
 
-          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-          # as `call_id` in `realtime.call.incoming`.
+          # The `live_...` ID of the pending SIP session. Forward this value unchanged when
+          # accepting or rejecting the call through the Live API.
           sig { returns(String) }
           attr_accessor :session_id
 
-          # Headers from the SIP Invite.
+          # Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+          # names, values, repeated entries, and order are preserved. Treat these values as
+          # untrusted call metadata.
           sig { returns(T::Array[OpenAI::Webhooks::LiveCallIncomingWebhookEvent::Data::SipHeader]) }
           attr_accessor :sip_headers
 
@@ -121,11 +123,13 @@ module OpenAI
           end
           def self.new(
 
-            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-            # as `call_id` in `realtime.call.incoming`.
+            # The `live_...` ID of the pending SIP session. Forward this value unchanged when
+            # accepting or rejecting the call through the Live API.
             session_id:,
 
-            # Headers from the SIP Invite.
+            # Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+            # names, values, repeated entries, and order are preserved. Treat these values as
+            # untrusted call metadata.
 
             sip_headers:
           )

data/rbi/openai/models/webhooks/realtime_call_incoming_webhook_event.rbi

@@ -100,12 +100,16 @@ module OpenAI
             )
           end
 
-          # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-          # as `session_id` in `live.call.incoming`.
+          # The Transceiver `rtc_...` ID of the pending SIP session. The paired
+          # `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+          # prefix with `live_`. Use the ID returned by the event with the corresponding
+          # Realtime or Live API.
           sig { returns(String) }
           attr_accessor :call_id
 
-          # Headers from the SIP Invite.
+          # Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+          # names, values, repeated entries, and order are preserved. Treat these values as
+          # untrusted call metadata.
           sig { returns(T::Array[OpenAI::Webhooks::RealtimeCallIncomingWebhookEvent::Data::SipHeader]) }
           attr_accessor :sip_headers
 
@@ -121,11 +125,15 @@ module OpenAI
           end
           def self.new(
 
-            # The Transceiver `rtc_...` ID of the pending SIP session. The same value appears
-            # as `session_id` in `live.call.incoming`.
+            # The Transceiver `rtc_...` ID of the pending SIP session. The paired
+            # `live.call.incoming` event derives its `session_id` by replacing the `rtc_`
+            # prefix with `live_`. Use the ID returned by the event with the corresponding
+            # Realtime or Live API.
             call_id:,
 
-            # Headers from the SIP Invite.
+            # Headers from the SIP INVITE, excluding SIP authorization headers. Retained
+            # names, values, repeated entries, and order are preserved. Treat these values as
+            # untrusted call metadata.
 
             sip_headers:
           )

data/rbi/openai/resources/admin/organization/audit_logs.rbi

@@ -49,7 +49,7 @@ module OpenAI
             effective_at: nil,
             # Return only events with a `type` in one of these values. For example,
             # `project.created`. For all options, see the documentation for the
-            # [audit log object](https://platform.openai.com/docs/api-reference/audit-logs/object).
+            # [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
             event_types: nil,
             # A limit on the number of objects to be returned. Limit can range between 1 and
             # 100, and the default is 20.