OpenAI
o3-mini model retirement
Stopped workingSubscribe to OpenAIShare
On October 23, 2026, the model o3-mini was retired. Requests targeting model o3-mini fail since that day. This retirement also covers the snapshot o3-mini-2025-01-31.
The error you get
What OpenAI answers a call to o3-mini once the model is gone, as recorded from real responses:
{"error":{"message":"The model `o3-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations","type":"invalid_request_error","param":null,"code":"model_not_found"}}What to use instead of o3-mini
Move to gpt-5.6-sol, which OpenAI recommends as the substitute model.
In OpenAI's words
Shutdown date: October 23, 2026; Model snapshot: o3-mini-2025-01-31 | o3-mini; Substitute model: gpt-5.6-sol
Facts
- API
- OpenAI
api.openai.com - Model
o3-mini- Released
- December 20, 2024 (models.dev)
- Kind
- Model retirement
- Takes effect
- October 23, 2026
- Calls after that day
- Fail
- Source
- Deprecations page
- Last updated
- Verified
- , against OpenAI's own pages
Questions
When does o3-mini shut down?
Calls to the model o3-mini on OpenAI stopped working on October 23, 2026.
What happens to calls after October 23, 2026?
They have failed since October 23, 2026.
What error does o3-mini return once it is shut down?
OpenAI answers HTTP 404: "The model `o3-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations". Send another model to fix it.
When was o3-mini released?
o3-mini was released on December 20, 2024, according to models.dev.
How do I find the calls this hits in my code?
Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.
o3-mini on other APIs 2
-
Azure AI Foundry
o3-miniModel retirement Stops workingin 13 days -
No date
Azure OpenAI
o3-miniModel retirement Deprecated, no date
More from OpenAI 10
-
ft-babbage-002Model retirement Stopped working -
ft-davinci-002Model retirement Stopped working -
ft-gpt-3.5-turboModel retirement Stopped working -
ft-gpt-4Model retirement Stopped working -
ft-gpt-4.1-nanoModel retirement Stopped working -
ft-gpt-4.1-nano-2025-04-14Model retirement Stopped working -
ft-o4-miniModel retirement Stopped working -
ft-o4-mini-2025-04-16Model retirement Stopped working -
gpt-3.5-turboModel retirement Stopped working -
gpt-3.5-turbo-0125Model retirement Stopped working
You fixed this one by hand.
Okapi opens the pull request with the fix before the next breaking change reaches your code.