Microsoft Foundry / Azure OpenAI · model

o4-mini deprecation: shutdown date & replacement

Shuts down November 19, 2026 — in 54 days
Provider
Microsoft Foundry / Azure OpenAI
Name
o4-mini (2025-04-16)
Type
model
Announced
—
Shutdown
Replacement
gpt-5.6-terra
Source
Official Microsoft Foundry / Azure OpenAI notice

Azure lifecycle stage: Deprecated. Version 2025-04-16.

How to migrate off o4-mini

  1. Find every place that references it:
    grep -rn --exclude-dir={node_modules,.git,dist} "o4-mini" .
  2. Replace the model ID:
    - model: "o4-mini"
    + model: "gpt-5.6-terra"
  3. Re-run your evals or a sample of real prompts — output style, token usage and pricing can change between models.
  4. Check config outside code too: environment variables, feature flags, prompt-management tools, and fine-tuned model references.
  5. Deploy before November 19, 2026, and add the CI scanner so it cannot come back.

Also shutting down on November 19, 2026 (Microsoft Foundry / Azure OpenAI)

Questions

Is o4-mini deprecated?

Yes. Microsoft Foundry / Azure OpenAI has deprecated o4-mini. It shuts down on November 19, 2026.

When does o4-mini shut down?

November 19, 2026, according to Microsoft Foundry / Azure OpenAI's official deprecation notice.

What should I use instead of o4-mini?

Microsoft Foundry / Azure OpenAI recommends gpt-5.6-terra. Switch the model ID and re-test your prompts, since outputs, pricing and limits can differ.

What happens to requests to o4-mini after the shutdown?

Requests using the retired model ID fail with an error, so any code still calling it breaks. Update and deploy before the shutdown date.

ModelSunset Alerts

Hear about a shutdown before your users do

Tell us which models and providers you depend on. We email you (or ping Slack) the day a deprecation is announced, and again 90, 30 and 7 days before shutdown.

  • Watchlist of up to 50 models across all providers
  • Instant alert when a new deprecation is published
  • Reminders 90 / 30 / 7 days before shutdown
  • Slack and email, weekly digest for your team

$5/ month

Early access pricing. Cancel anytime. Payments by Creem.