Okapi Okapi

OpenAI o4-mini model retirement

Stopped workingSubscribe to OpenAIShare

On October 23, 2026, the o4-mini model was retired. Requests targeting model o4-mini fail since that day. This shutdown also affected the o4-mini-2025-04-16 snapshot.


The error you get

What OpenAI answers a call to o4-mini once the model is gone, as recorded from real responses:

HTTP 404
{"error":{"message":"The model `o4-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 o4-mini

Move to gpt-5.6-terra, which is recommended by OpenAI as the substitute model.

In OpenAI's words

Shutdown date: October 23, 2026; Model snapshot: o4-mini-2025-04-16 | o4-mini; Substitute model: gpt-5.6-terra

OpenAI, Deprecations page

Facts

API
OpenAI api.openai.com
Model
o4-mini
Released
April 16, 2025 (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 o4-mini shut down?

Calls to the model o4-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 o4-mini return once it is shut down?

OpenAI answers HTTP 404: "The model `o4-mini` has been deprecated, learn more here: https://platform.openai.com/docs/deprecations". Send another model to fix it.

When was o4-mini released?

o4-mini was released on April 16, 2025, 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.


o4-mini on other APIs 2

  1. Azure AI Foundry o4-miniModel retirement Stops workingin 13 days
  2. Azure OpenAI o4-miniModel retirement Stops workingin 344 days

More from OpenAI 10

  1. ft-babbage-002Model retirement Stopped working
  2. ft-davinci-002Model retirement Stopped working
  3. ft-gpt-3.5-turboModel retirement Stopped working
  4. ft-gpt-4Model retirement Stopped working
  5. ft-gpt-4.1-nanoModel retirement Stopped working
  6. ft-gpt-4.1-nano-2025-04-14Model retirement Stopped working
  7. ft-o4-miniModel retirement Stopped working
  8. ft-o4-mini-2025-04-16Model retirement Stopped working
  9. gpt-3.5-turboModel retirement Stopped working
  10. 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.

Add to GitHub

Get notifications

Subscribe to OpenAI

Hear about each breaking change OpenAI announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • OpenAI

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.