[FEATURE REQ] `ChatReasoningEffortLevel` is missing `Minimal` option

[kurnakovv]

Describe the feature or improvement you are requesting

According to the official OpenAI API documentation, the reasoning_effort parameter currently supports four values:

• minimal
• low
• medium
• high

However, in the generated SDK (ChatReasoningEffortLevel class), only three values are available:

• Low
• Medium
• High

The Minimal option is missing, which causes inconsistencies between the documentation and SDK.

Additional context

No response

[jsquire]

Hi @kurnakovv. Thanks for reaching out and we regret that you're experiencing difficulties. The minimal value was recently added to the service and has not yet been released as part of the REST API specification that the library is generated from. Once the spec has been updated with the value, it will be added to the client.

In the meantime, you can make use of the value by dropping to the protocol level as demonstrated in Example07_ChatProtocol..

[tomw-twinthread]

how long does it typically take to update the api spec?

It's been over a month and a half since gpt 5 was released

[jsquire]

@tomw-twinthread: The spec updates happen upstream and then flow down to the libraries, so we do not have a great deal of insight nor influence over them. Generally speaking, the updates lag behind the service release by a couple of weeks. My understanding is that the gpt-5 service release caused an issue in the spec metadata that broke the tooling, which has delayed the updates. This is currently being worked through by the folks who own the spec.