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-09-15: Various older command models, a number of endpoints, all of fine-tuning.
Effective September 15, 2025, the following deprecatations will roll out.
Deprecated Models:
command-r-03-2024
(and the aliascommand-r
)command-r-plus-04-2024
(and the aliascommand-r-plus
)command-light
command
summarize
(Refer to the migration guide for alternatives).
For command model replacements, we recommend you use command-r-08-2024
, command-r-plus-08-2024
, or command-a-03-2025
(which is the strongest-performing model across domains) instead.
Retired Fine-Tuning Capabilities:
Fine-tuning for the command-light
, command
, command-r
, classify
, and rerank
models is being retired. This covers both the Cohere dashboard and API. Previously fine-tuned models will no longer be accessible.
Deprecated Features and API Endpoints:
/v1/connectors
(Managed connectors for RAG)/v1/chat
parameters:connectors
,search_queries_only
/v1/generate
(Legacy generative endpoint)/v1/summarize
(Legacy summarization endpoint)/v1/classify
- Slack App integration
- Coral Web UI (chat.cohere.com and coral.cohere.com)
These changes reflect our commitment to innovation and performance optimization. We encourage users to assess their current implementations and migrate to recommended alternatives. Our support team is available at support@cohere.com to assist with the transition. For detailed guidance, please refer to our migration resources and technical documentation.
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.