Microsoft Foundry / Azure OpenAI · model
o4-mini deprecation: shutdown date & replacement
- 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
- Find every place that references it:
grep -rn --exclude-dir={node_modules,.git,dist} "o4-mini" . - Replace the model ID:
- model: "o4-mini" + model: "gpt-5.6-terra" - Re-run your evals or a sample of real prompts — output style, token usage and pricing can change between models.
- Check config outside code too: environment variables, feature flags, prompt-management tools, and fine-tuned model references.
- 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.