openai 0.87.0 → 0.89.0

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -32,7 +32,7 @@ module OpenAI
           attr_accessor :type
 
           # Whether to run the model response in the background.
-          # [Learn more](https://platform.openai.com/docs/guides/background).
+          # [Learn more](https://developers.openai.com/api/docs/guides/background).
           sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :background
 
@@ -74,11 +74,11 @@ module OpenAI
           #
           # Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Image inputs](https://platform.openai.com/docs/guides/images)
-          # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-          # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-          # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           sig { returns(T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Input::Variants)) }
           attr_reader :input
 
@@ -95,7 +95,7 @@ module OpenAI
 
           # An upper bound for the number of tokens that can be generated for a response,
           # including visible output tokens and
-          # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
           sig { returns(T.nilable(Integer)) }
           attr_accessor :max_output_tokens
 
@@ -118,8 +118,8 @@ module OpenAI
           # Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
           # range of models with different capabilities, performance characteristics, and
           # price points. Refer to the
-          # [model guide](https://platform.openai.com/docs/models) to browse and compare
-          # available models.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           sig {
             returns(T.nilable(T.any(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::OrSymbol, String)))
           }
@@ -156,13 +156,13 @@ module OpenAI
 
           # The unique ID of the previous response to the model. Use this to create
           # multi-turn conversations. Learn more about
-          # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+          # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
           # Cannot be used in conjunction with `conversation`.
           sig { returns(T.nilable(String)) }
           attr_accessor :previous_response_id
 
           # Reference to a prompt template and its variables.
-          # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+          # [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
           sig { returns(T.nilable(OpenAI::Beta::BetaResponsePrompt)) }
           attr_reader :prompt
 
@@ -171,7 +171,7 @@ module OpenAI
 
           # Used by OpenAI to cache responses for similar requests to optimize your cache
           # hit rates. Replaces the `user` field.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
           sig { returns(T.nilable(String)) }
           attr_accessor :prompt_cache_key
 
@@ -182,7 +182,7 @@ module OpenAI
           # up to the latest 80 breakpoints in the conversation, without a content-block
           # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
           # `ttl` defaults to `30m`, which is currently the only supported value. See the
-          # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+          # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           # for current details.
           sig { returns(T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions)) }
           attr_reader :prompt_cache_options
@@ -200,7 +200,7 @@ module OpenAI
           # The retention policy for the prompt cache. Set to `24h` to enable extended
           # prompt caching, which keeps cached prefixes active for longer, up to a maximum
           # of 24 hours.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
           # This field expresses a maximum retention policy, while
           # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
           # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
@@ -218,7 +218,7 @@ module OpenAI
           attr_accessor :prompt_cache_retention
 
           # Configuration options for
-          # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+          # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
           sig { returns(T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning)) }
           attr_reader :reasoning
 
@@ -232,7 +232,7 @@ module OpenAI
           # identifies each user, with a maximum length of 64 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           sig { returns(T.nilable(String)) }
           attr_accessor :safety_identifier
 
@@ -243,13 +243,15 @@ module OpenAI
           #   will use 'default'.
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
-          # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)',
-          #   then the request will be processed with the Flex Processing service tier.
-          # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #   include the `service_tier=fast` or `service_tier=priority` parameter for
-          #   Responses or Chat Completions. The response will show `service_tier=priority`
-          #   regardless of if you specify `service_tier=fast` or `priority` in your
-          #   request.
+          # - If set to
+          #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #   the request will be processed with the Flex Processing service tier.
+          # - To opt-in to
+          #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #   request level, include the `service_tier=fast` or `service_tier=priority`
+          #   parameter for Responses or Chat Completions. The response will show
+          #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #   `priority` in your request.
           # - If set to 'ultrafast', then the request will be processed with the
           #   access-controlled Ultrafast Processing service tier. This tier is currently
           #   available for `gpt-5.6-sol`; a response served through it will show
@@ -266,7 +268,7 @@ module OpenAI
           # Whether to store the generated model response for later retrieval via API.
           # Defaults to true when omitted. If set to true, response data will be stored for
           # at least 30 days, subject to the
-          # [data retention exceptions](/api/docs/guides/your-data#v1responses).
+          # [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
           sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :store
 
@@ -274,7 +276,7 @@ module OpenAI
           # generated using
           # [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
           # See the
-          # [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+          # [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
           # for more information.
           sig { returns(T.nilable(T::Boolean)) }
           attr_accessor :stream
@@ -312,8 +314,8 @@ module OpenAI
           # Configuration options for a text response from the model. Can be plain text or
           # structured JSON data. Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
           sig { returns(T.nilable(OpenAI::Beta::BetaResponseTextConfig)) }
           attr_reader :text
 
@@ -367,17 +369,18 @@ module OpenAI
           #
           # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
           #   capabilities, like
-          #   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-          #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+          #   [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+          #   or
+          #   [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
           #   Learn more about
-          #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+          #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
           # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
           #   predefined connectors such as Google Drive and SharePoint. Learn more about
-          #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+          #   [MCP Tools](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
           # - **Function calls (custom tools)**: Functions that are defined by you, enabling
           #   the model to call your own code with strongly typed arguments and outputs.
           #   Learn more about
-          #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+          #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
           #   You can also use custom tools to call your own code.
           sig {
             returns(
@@ -462,7 +465,7 @@ module OpenAI
           # `prompt_cache_key` instead to maintain caching optimizations. A stable
           # identifier for your end-users. Used to boost cache hit rates by better bucketing
           # similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
           sig { returns(T.nilable(String)) }
           attr_reader :user
 
@@ -587,7 +590,7 @@ module OpenAI
           def self.new(
 
             # Whether to run the model response in the background.
-            # [Learn more](https://platform.openai.com/docs/guides/background).
+            # [Learn more](https://developers.openai.com/api/docs/guides/background).
             background: nil,
 
             # Context management configuration for this request.
@@ -623,11 +626,11 @@ module OpenAI
             #
             # Learn more:
             #
-            # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-            # - [Image inputs](https://platform.openai.com/docs/guides/images)
-            # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-            # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-            # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+            # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+            # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+            # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+            # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+            # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
             input: nil,
 
             # A system (or developer) message inserted into the model's context.
@@ -639,7 +642,7 @@ module OpenAI
 
             # An upper bound for the number of tokens that can be generated for a response,
             # including visible output tokens and
-            # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+            # [reasoning tokens](https://developers.openai.com/api/docs/guides/reasoning).
             max_output_tokens: nil,
 
             # The maximum number of total calls to built-in tools that can be processed in a
@@ -659,8 +662,8 @@ module OpenAI
             # Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
             # range of models with different capabilities, performance characteristics, and
             # price points. Refer to the
-            # [model guide](https://platform.openai.com/docs/models) to browse and compare
-            # available models.
+            # [model guide](https://developers.openai.com/api/docs/models) to browse and
+            # compare available models.
             model: nil,
 
             # Configuration for running moderation on the input and output of this response.
@@ -674,17 +677,17 @@ module OpenAI
 
             # The unique ID of the previous response to the model. Use this to create
             # multi-turn conversations. Learn more about
-            # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+            # [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
             # Cannot be used in conjunction with `conversation`.
             previous_response_id: nil,
 
             # Reference to a prompt template and its variables.
-            # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+            # [Learn more](https://developers.openai.com/api/docs/guides/text?api-mode=responses#version-prompts-in-code).
             prompt: nil,
 
             # Used by OpenAI to cache responses for similar requests to optimize your cache
             # hit rates. Replaces the `user` field.
-            # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+            # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching).
             prompt_cache_key: nil,
 
             # Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -694,7 +697,7 @@ module OpenAI
             # up to the latest 80 breakpoints in the conversation, without a content-block
             # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
             # `ttl` defaults to `30m`, which is currently the only supported value. See the
-            # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+            # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
             # for current details.
             prompt_cache_options: nil,
 
@@ -703,7 +706,7 @@ module OpenAI
             # The retention policy for the prompt cache. Set to `24h` to enable extended
             # prompt caching, which keeps cached prefixes active for longer, up to a maximum
             # of 24 hours.
-            # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+            # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
             # This field expresses a maximum retention policy, while
             # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
             # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
@@ -718,7 +721,7 @@ module OpenAI
             prompt_cache_retention: nil,
 
             # Configuration options for
-            # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+            # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
             reasoning: nil,
 
             # A stable identifier used to help detect users of your application that may be
@@ -726,7 +729,7 @@ module OpenAI
             # identifies each user, with a maximum length of 64 characters. We recommend
             # hashing their username or email address, in order to avoid sending us any
             # identifying information.
-            # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+            # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
             safety_identifier: nil,
 
             # Specifies the processing type used for serving the request.
@@ -736,13 +739,15 @@ module OpenAI
             #   will use 'default'.
             # - If set to 'default', then the request will be processed with the standard
             #   pricing and performance for the selected model.
-            # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)',
-            #   then the request will be processed with the Flex Processing service tier.
-            # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-            #   include the `service_tier=fast` or `service_tier=priority` parameter for
-            #   Responses or Chat Completions. The response will show `service_tier=priority`
-            #   regardless of if you specify `service_tier=fast` or `priority` in your
-            #   request.
+            # - If set to
+            #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+            #   the request will be processed with the Flex Processing service tier.
+            # - To opt-in to
+            #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+            #   request level, include the `service_tier=fast` or `service_tier=priority`
+            #   parameter for Responses or Chat Completions. The response will show
+            #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+            #   `priority` in your request.
             # - If set to 'ultrafast', then the request will be processed with the
             #   access-controlled Ultrafast Processing service tier. This tier is currently
             #   available for `gpt-5.6-sol`; a response served through it will show
@@ -758,14 +763,14 @@ module OpenAI
             # Whether to store the generated model response for later retrieval via API.
             # Defaults to true when omitted. If set to true, response data will be stored for
             # at least 30 days, subject to the
-            # [data retention exceptions](/api/docs/guides/your-data#v1responses).
+            # [data retention exceptions](https://developers.openai.com/api/docs/guides/your-data#v1responses).
             store: nil,
 
             # If set to true, the model response data will be streamed to the client as it is
             # generated using
             # [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
             # See the
-            # [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+            # [Streaming section below](https://developers.openai.com/api/reference/resources/responses/streaming-events)
             # for more information.
             stream: nil,
 
@@ -788,8 +793,8 @@ module OpenAI
             # Configuration options for a text response from the model. Can be plain text or
             # structured JSON data. Learn more:
             #
-            # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-            # - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+            # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+            # - [Structured Outputs](https://developers.openai.com/api/docs/guides/structured-outputs)
             text: nil,
 
             # How the model should select which tool (or tools) to use when generating a
@@ -804,17 +809,18 @@ module OpenAI
             #
             # - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
             #   capabilities, like
-            #   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
-            #   [file search](https://platform.openai.com/docs/guides/tools-file-search).
+            #   [web search](https://developers.openai.com/api/docs/guides/tools-web-search)
+            #   or
+            #   [file search](https://developers.openai.com/api/docs/guides/tools-file-search).
             #   Learn more about
-            #   [built-in tools](https://platform.openai.com/docs/guides/tools).
+            #   [built-in tools](https://developers.openai.com/api/docs/guides/tools).
             # - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
             #   predefined connectors such as Google Drive and SharePoint. Learn more about
-            #   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+            #   [MCP Tools](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
             # - **Function calls (custom tools)**: Functions that are defined by you, enabling
             #   the model to call your own code with strongly typed arguments and outputs.
             #   Learn more about
-            #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+            #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
             #   You can also use custom tools to call your own code.
             tools: nil,
 
@@ -843,7 +849,7 @@ module OpenAI
             # `prompt_cache_key` instead to maintain caching optimizations. A stable
             # identifier for your end-users. Used to boost cache hit rates by better bucketing
             # similar requests and to help OpenAI detect and prevent abuse.
-            # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+            # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
             user: nil,
 
             # The type of the client event. Always `response.create`.
@@ -1001,11 +1007,11 @@ module OpenAI
           #
           # Learn more:
           #
-          # - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
-          # - [Image inputs](https://platform.openai.com/docs/guides/images)
-          # - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
-          # - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
-          # - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+          # - [Text inputs and outputs](https://developers.openai.com/api/docs/guides/text)
+          # - [Image inputs](https://developers.openai.com/api/docs/guides/images-vision)
+          # - [File inputs](https://developers.openai.com/api/docs/guides/file-inputs)
+          # - [Conversation state](https://developers.openai.com/api/docs/guides/conversation-state)
+          # - [Function calling](https://developers.openai.com/api/docs/guides/function-calling)
           module Input
             extend OpenAI::Internal::Type::Union
 
@@ -1020,8 +1026,8 @@ module OpenAI
           # Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
           # range of models with different capabilities, performance characteristics, and
           # price points. Refer to the
-          # [model guide](https://platform.openai.com/docs/models) to browse and compare
-          # available models.
+          # [model guide](https://developers.openai.com/api/docs/models) to browse and
+          # compare available models.
           module Model
             extend OpenAI::Internal::Type::Union
 
@@ -1798,7 +1804,7 @@ module OpenAI
             # up to the latest 80 breakpoints in the conversation, without a content-block
             # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
             # `ttl` defaults to `30m`, which is currently the only supported value. See the
-            # [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+            # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
             # for current details.
             sig do
               params(
@@ -1916,7 +1922,7 @@ module OpenAI
           # The retention policy for the prompt cache. Set to `24h` to enable extended
           # prompt caching, which keeps cached prefixes active for longer, up to a maximum
           # of 24 hours.
-          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+          # [Learn more](https://developers.openai.com/api/docs/guides/prompt-caching#prompt-cache-retention).
           # This field expresses a maximum retention policy, while
           # `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
           # are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
@@ -1977,7 +1983,7 @@ module OpenAI
             # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
             # reasoning effort can result in faster responses and fewer tokens used on
             # reasoning in a response. Not all reasoning models support every value. See the
-            # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+            # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
             # model-specific support.
             sig {
               returns(T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Effort::OrSymbol))
@@ -2028,7 +2034,7 @@ module OpenAI
             attr_accessor :summary
 
             # Configuration options for
-            # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+            # [reasoning models](https://developers.openai.com/api/docs/guides/reasoning).
             sig do
               params(
 
@@ -2060,7 +2066,7 @@ module OpenAI
               # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
               # reasoning effort can result in faster responses and fewer tokens used on
               # reasoning in a response. Not all reasoning models support every value. See the
-              # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+              # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
               # model-specific support.
               effort: nil,
 
@@ -2149,7 +2155,7 @@ module OpenAI
             # are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
             # reasoning effort can result in faster responses and fewer tokens used on
             # reasoning in a response. Not all reasoning models support every value. See the
-            # [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+            # [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
             # model-specific support.
             module Effort
               extend OpenAI::Internal::Type::Enum
@@ -2304,13 +2310,15 @@ module OpenAI
           #   will use 'default'.
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
-          # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)',
-          #   then the request will be processed with the Flex Processing service tier.
-          # - To opt-in to [Fast mode](/api/docs/guides/fast-mode) at the request level,
-          #   include the `service_tier=fast` or `service_tier=priority` parameter for
-          #   Responses or Chat Completions. The response will show `service_tier=priority`
-          #   regardless of if you specify `service_tier=fast` or `priority` in your
-          #   request.
+          # - If set to
+          #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+          #   the request will be processed with the Flex Processing service tier.
+          # - To opt-in to
+          #   [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+          #   request level, include the `service_tier=fast` or `service_tier=priority`
+          #   parameter for Responses or Chat Completions. The response will show
+          #   `service_tier=priority` regardless of if you specify `service_tier=fast` or
+          #   `priority` in your request.
           # - If set to 'ultrafast', then the request will be processed with the
           #   access-controlled Ultrafast Processing service tier. This tier is currently
           #   available for `gpt-5.6-sol`; a response served through it will show

data/rbi/openai/models/beta/beta_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:
           #

data/rbi/openai/models/beta/beta_tool_choice_types.rbi

@@ -17,7 +17,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:
         #
@@ -32,7 +32,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(
 
@@ -43,7 +43,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:
           #
@@ -68,7 +68,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/beta/beta_web_search_preview_tool.rbi

@@ -47,7 +47,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/beta/beta_web_search_tool.rbi

@@ -52,7 +52,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/beta/file_search_tool.rbi

@@ -67,7 +67,7 @@ module OpenAI
           #
           # Note that the file search tool may output fewer than `max_num_results` results.
           # See the
-          # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+          # [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
           # for more information.
           sig { returns(T.nilable(Integer)) }
           attr_reader :max_num_results
@@ -79,7 +79,7 @@ module OpenAI
           # will use the `auto` ranker and a score_threshold of 0.
           #
           # See the
-          # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+          # [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
           # for more information.
           sig { returns(T.nilable(OpenAI::Beta::FileSearchTool::FileSearch::RankingOptions)) }
           attr_reader :ranking_options
@@ -105,7 +105,7 @@ module OpenAI
             #
             # Note that the file search tool may output fewer than `max_num_results` results.
             # See the
-            # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+            # [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
             # for more information.
             max_num_results: nil,
 
@@ -113,7 +113,7 @@ module OpenAI
             # will use the `auto` ranker and a score_threshold of 0.
             #
             # See the
-            # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+            # [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
             # for more information.
 
             ranking_options: nil
@@ -153,7 +153,7 @@ module OpenAI
             # will use the `auto` ranker and a score_threshold of 0.
             #
             # See the
-            # [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search#customizing-file-search-settings)
+            # [file search tool documentation](https://developers.openai.com/api/docs/guides/tools-file-search#retrieval-customization)
             # for more information.
             sig do
               params(