Guide · Model retirement · OpenAI GPT-5 and o3

GPT-5 and o3 models retire on 11 December 2026: what to do before the date

OpenAI removes gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-pro, o3 and o3-pro from the API on 11 December 2026. The recommended replacements are gpt-5.6-sol, gpt-5.6-terra and gpt-5.6-luna. OpenAI says that at shutdown a model is no longer accessible; it does not say requests will be routed to the replacement. Switch and re-test your own tasks before the date.

The models, by ID

ModelModel IDsShutdownRecommended replacement
GPT-5gpt-5, gpt-5-2025-08-07gpt-5, gpt-5-2025-08-0711 Dec 2026gpt-5.6-sol
GPT-5 minigpt-5-mini, gpt-5-mini-2025-08-07gpt-5-mini, gpt-5-mini-2025-08-0711 Dec 2026gpt-5.6-terra
GPT-5 nanogpt-5-nano, gpt-5-nano-2025-08-07gpt-5-nano, gpt-5-nano-2025-08-0711 Dec 2026gpt-5.6-luna
GPT-5 progpt-5-pro, gpt-5-pro-2025-10-06gpt-5-pro, gpt-5-pro-2025-10-0611 Dec 2026gpt-5.6-sol (reasoning.mode: pro)
o3o3, o3-2025-04-16o3, o3-2025-04-1611 Dec 2026gpt-5.6-sol
o3-proo3-pro, o3-pro-2025-06-10o3-pro, o3-pro-2025-06-1011 Dec 2026gpt-5.6-sol (reasoning.mode: pro)

Read from OpenAI's API deprecations page on 12 November 2026 (notice dated 11 June 2026). OpenAI adds that fine-tuned versions of these models follow the same shutdown schedule as their base models. Nearby OpenAI dates: on 30 November 2026 Agent Builder, the Evals dashboard and API, and the v1/prompts API with reusable prompt objects shut down; on 14 January 2027 the gpt-4o, gpt-4o-mini, gpt-4.1 and gpt-4.1-mini snapshots listed there go, with gpt-6-luna as the replacement. All of them are in our model retirement calendar.

Azure OpenAI has its own schedule. On 12 November 2026 Microsoft's Foundry model retirement schedule (last updated 23 September 2026) listed o3 and o3-pro as deprecated with retirement on 19 November 2026, earlier than on OpenAI's API, and gpt-5.6-sol as replacement. It listed later dates for the GPT-5 family: gpt-5 and gpt-5-nano 9 February 2027, gpt-5-pro 7 April 2027, gpt-5-mini 13 July 2027. Check that page for your deployment.

What happens if you do nothing

Migration checklist

  1. Find every call site and model ID. Search code, config, environment variables and framework defaults for gpt-5, o3 and the dated snapshots. Note the reasoning effort setting at each call site.
  2. Freeze 20–30 real tasks with expected answers. Include the cases that must never go wrong; write the answers down before any run.
  3. Run the old and candidate setups on the same tasks. Your current model, the named replacement, and one alternative (for example the next tier down, or a lower reasoning setting). Same prompts, same tools, same grading.
  4. Compare cost per finished task and the named tasks that change. Count retries and failures in the cost. List exactly which tasks each setup gets wrong; an average hides them.
  5. Check the mechanics. Tool calls, structured output against your schema, latency, rate limits and reasoning token use on the new model.
  6. Roll out behind a flag. Move a share of traffic, watch the frozen set and production, then switch fully before 11 December.
  7. Keep the evidence. Store the task set, results and decision. The 14 January 2027 retirements need the same test.

Why averages mislead

In our public test of the Aider coding agent on 27 tasks with hidden tests, Claude Sonnet solved the same 26 tasks as Claude Opus at 49% lower cost per solved task. Claude Haiku was far cheaper but failed 4 more tasks, mostly edge cases. An average hides that; the named failures show whether those 4 tasks matter to you.

That test used Claude models, not OpenAI. The method is the same for any switch, including o3 or GPT-5 to the GPT-5.6 family: same tasks, known answers, cost per finished task, failures by name. Full method and raw data: Aider cost vs quality report.

Test your switch before 11 December

Free pilot: send 20–30 of your tasks with expected answers. We run 3 setups (your current GPT-5 or o3 setup and two candidates) and send a one-page report: cost per finished task and every task each setup gets wrong.

7-day test, $1,390 fixed: 20 tasks, 3 setups, a signed report in 7 working days with a recommendation.

We work in writing: use the “Write to us” chat on this page or e-mail hello@agenttrustapi.com.

For agents: the calendar is also a JSON file and an Atom feed, each with source and check date.

Questions people ask

When are GPT-5 and o3 retired on the OpenAI API?

On 11 December 2026: gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-pro, o3 and o3-pro, including their dated snapshots, per OpenAI's API deprecations page (checked 12 November 2026).

What replaces GPT-5, GPT-5 mini, GPT-5 nano and o3?

OpenAI recommends gpt-5.6-sol for gpt-5 and o3, gpt-5.6-terra for gpt-5-mini, gpt-5.6-luna for gpt-5-nano, and gpt-5.6-sol with reasoning.mode: pro for gpt-5-pro and o3-pro. Test one alternative on your own tasks too.

Will my requests fail after 11 December?

Plan for that. OpenAI's page says that at the time of the shutdown the model will no longer be accessible, and it does not say requests are routed to a replacement. Change the model ID and re-test before the date.

Are my fine-tuned GPT-5 or o3 models affected?

Yes. OpenAI says fine-tuned versions of these models follow the same shutdown schedule as their underlying base models.

Are the Azure OpenAI dates the same?

No. On 12 November 2026 Microsoft's Foundry model retirement schedule listed o3 and o3-pro for 19 November 2026, earlier than OpenAI's API, and later dates for the GPT-5 family (gpt-5 and gpt-5-nano 9 February 2027, gpt-5-pro 7 April 2027, gpt-5-mini 13 July 2027). Check that page for your deployment.

How do I test the switch before the deadline?

Freeze 20–30 real tasks with expected answers, run your current setup and the candidates on the same set, compare cost per finished task and the named tasks that change, and roll out behind a flag. We run this as a free pilot, or as a fixed 7-day test for $1,390.

Questions or corrections: hello@agenttrustapi.com.