docsFind information around deprecated endpoints and models with their recommended replacements.
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:
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.
All deprecations are listed below with the most recent announcements at the top.
Effective April 4th, 2026, the following models will be retired:
embed-english-v2.0embed-english-light-v2.0embed-multilingual-v2.0c4ai-aya-expanse-8bc4ai-aya-vision-8bWe encourage you to migrate to our latest models, which offer enhanced performance, improved accuracy, and expanded capabilities:
embed-english-v3.0embed-multilingual-v3.0embed-v4.0command-r7b-12-2024command-a-03-2025command-a-reasoning-08-2025Our team is here to ensure a seamless transition. For questions or assistance, please don’t hesitate reaching out to us at support@cohere.com. Thank you for your continued partnership. We look forward to powering your applications with our latest AI advancements.
Effective September 15, 2025, the following deprecations will roll out.
Deprecated Models:
command-r-03-2024 (and the alias command-r)command-r-plus-04-2024 (and the alias command-r-plus)command-lightcommandsummarize (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/classifyThese 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.
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:
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.
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.
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.