Model deprecations
As safer and more capable models launch, Anthropic regularly retires older ones. Applications relying on Anthropic models may need occasional updates to keep working. Impacted customers will always be notified by email and in the documentation.
Anthropic uses the following terms to describe the model lifecycle:
- Active: The model is fully supported and recommended for use.
- Legacy: The model will no longer receive updates and may be deprecated in the future.
- Deprecated: The model is still functional but no longer recommended. Anthropic provides a recommended replacement and assigns a retirement date.
- Retired: The model is no longer available for use. Requests to retired models will fail.
Deprecated models are likely to be less reliable than active models. Move workloads to active models to maintain the highest level of support and reliability.
Once a model is deprecated, migrate all usage to a suitable replacement before the retirement date. Requests to models past the retirement date will fail.
Anthropic notifies customers with active deployments for models with upcoming retirements, providing at least 60 days notice before model retirement for publicly released models.
Upcoming June 15, 2026 retirements
On April 14, 2026, Anthropic notified developers using Claude Sonnet 4 and Claude Opus 4 models of their upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| June 15, 2026 | claude-sonnet-4-20250514 | claude-sonnet-4-6 |
| June 15, 2026 | claude-opus-4-20250514 | claude-opus-4-8 |
After June 15, any API calls to these models will return an error. There is no grace period and no gradual wind-down. The switch flips and requests fail.
Convenience aliases claude-opus-4-0 and claude-sonnet-4-0 resolve to the retiring snapshots and will also fail on June 15.
Additional upcoming retirement
On June 5, 2026, Anthropic notified developers using Claude Opus 4.1 of its upcoming retirement on the Claude API.
| Retirement date | Deprecated model | Recommended replacement |
|---|---|---|
| August 5, 2026 | claude-opus-4-1-20250805 | claude-opus-4-8 |
API parameter deprecations
| Parameter | Status | Behavior | Recommended replacement |
|---|---|---|---|
temperature, top_p, top_k | Deprecated (Claude Opus 4.7 and later) | Returns a 400 error when set to a non-default value on Claude Opus 4.7 and later, including Claude Opus 4.8. | Omit and use prompting to guide model behavior. |
Developers should audit API usage via the Claude Console Usage page export, update hardcoded model IDs in application code, CI/CD pipelines, Docker configs, and Kubernetes manifests, and test migrated code before the June 15 deadline.
Claude Mythos Preview (claude-mythos-preview) will be retired on June 30, 2026. To migrate to Claude Mythos 5 (claude-mythos-5), see the migration guide.