Okapi Okapi

OpenAI o4-mini-deep-research model retirement

Stopped workingSubscribe to OpenAIShare

On July 23, 2026, the o4-mini-deep-research model was retired. Calls targeting model o4-mini-deep-research fail since that day. This shutdown also affected the model snapshot o4-mini-deep-research-2025-06-26.


The error you get

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

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

Move to the substitute model gpt-5.6-sol, which OpenAI recommends.

In OpenAI's words

Shutdown date: July 23, 2026; Model snapshot: o4-mini-deep-research-2025-06-26 | o4-mini-deep-research; Substitute model: gpt-5.6-sol

OpenAI, Deprecations page

Facts

API
OpenAI api.openai.com
Model
o4-mini-deep-research
Released
June 26, 2025 (models.dev)
Kind
Model retirement
Takes effect
July 23, 2026
Calls after that day
Fail
Source
Deprecations page
Last updated
Verified
, against OpenAI's own pages

Questions

When does o4-mini-deep-research shut down?

Calls to the model o4-mini-deep-research on OpenAI stopped working on July 23, 2026.

What happens to calls after July 23, 2026?

They have failed since July 23, 2026.

What error does o4-mini-deep-research return once it is shut down?

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

When was o4-mini-deep-research released?

o4-mini-deep-research was released on June 26, 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.


More from OpenAI 10

  1. computer-use-previewModel retirement Stopped working
  2. computer-use-preview-2025-03-11Model retirement Stopped working
  3. gpt-4o-mini-search-previewModel retirement Stopped working
  4. gpt-4o-mini-search-preview-2025-03-11Model retirement Stopped working
  5. gpt-4o-search-previewModel retirement Stopped working
  6. gpt-4o-search-preview-2025-03-11Model retirement Stopped working
  7. gpt-5-chat-latestModel retirement Stopped working
  8. gpt-5-codexModel retirement Stopped working
  9. gpt-5.1-chat-latestModel retirement Stopped working
  10. gpt-5.1-codexModel 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.