Deprecations
Find information around deprecated endpoints and models with their recommended replacements.
Overview
As Cohere launches safer and more capable models, we will regularly retire old models. Applications relying on Cohere’s models may need occasional updates to keep working. Impacted customers will always be notified via email and in our documentation along with blog posts. This page lists all API deprecations, along with recommended replacements.
Cohere uses the following terms to describe the lifecycle of our models:
- Active: The model and endpoint are fully supported and recommended for use.
- Legacy: The model and endpoints will no longer receive updates and may be deprecated in the future.
- Deprecated: The model and endpoints are no longer available to new customers but remain available to existing users until retirement. (An existing user is defined as anyone who has used the model or endpoint within 90 days of the deprecation announcement.) A shutdown date will be assigned at that time.
- Shutdown: The model and endpoint are no longer available for users. Requests to shutdown models and endpoints will fail.
Migrating to replacements
Once a model is deprecated, it is imperative to migrate all usage to a suitable replacement before the shutdown date. Requests to models and endpoints past the shutdown date will fail. To ensure a smooth transition, we recommend thorough testing of your applications with the new models well before the shutdown date. If your team requires assistance, do not hesitate to reach out to support@cohere.ai.
Deprecation History
All deprecations are listed below with the most recent announcements at the top.
2025-03-08: Command-R-03-2024 Fine-tuned Models
On March 08, 2025, we will sunset all models fine-tuned with Command-R-03-2024. As part of our ongoing efforts to enhance our services, we are making the following changes to our fine-tuning capabilities:
- Deprecating fine-tuning with the older Command-R-03-2024 model
- All fine-tunes are now powered by the Command-R-08-2024 model.
Models fine-tuned with Command-R-03-2024 will continue to be supported until March 08, 2025. After this date, all requests to these models will return an error.
2025-01-31: Default Classify endpoint
After January 31st, 2025, usage of Classify endpoint via the default Embed models will be deprecated.
However, you can still use the Classify endpoint with a fine-tuned Embed model. By leveraging fine-tuning, you can achieve even better performance and accuracy in your classification tasks. Read the documentation on Classify fine-tuning for more information.
2024-12-02: Rerank v2.0
On December 2nd, 2024, we announced the release of Rerank-v3.5 along with the deprecation of the Rerank-v2.0 model family. Fine-tuned models created from these base models are not affected by this deprecation.
Best Practices:
- Regularly check our documentation for updates on announcements regarding the status of models.
- Test applications with newer models well before the shutdown date of your current model.
- Update any production code to use an active model as soon as possible.
- Contact support@cohere.ai if you need any assistance with migration or have any questions.