Okapi Okapi

OpenAI o3-deep-research model retirement

Stopped workingSubscribe to OpenAIShare

On July 23, 2026, the model o3-deep-research reached its shutdown date. Requests targeting model o3-deep-research fail since that day.


The error you get

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

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

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

In OpenAI's words

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

OpenAI, Deprecations page

Facts

API
OpenAI api.openai.com
Model
o3-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 o3-deep-research shut down?

Calls to the model o3-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 o3-deep-research return once it is shut down?

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

When was o3-deep-research released?

o3-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.


o3-deep-research on other APIs 1

  1. Azure AI Foundry o3-deep-researchModel retirement Stops workingin 13 days

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.