2026-06-08 08:29 UTC · openai/deprecations · live page
Summary by gemma-4-12b. It may be wrong; the diff below is what actually changed. Raw: c9bcbbf107-openai-deprecations.diff · commit c9bcbbf107
diff --git a/snapshots/openai/deprecations.md b/snapshots/openai/deprecations.mdindex a401871..19c040c 100644--- a/snapshots/openai/deprecations.md+++ b/snapshots/openai/deprecations.md@@ -7,4 +7,18 @@ As we launch safer and more capable models, we regularly retire older models. So This page lists all API deprecations, along with recommended replacements. +## Model deprecation notice periods++We provide advance notice before retiring models so customers have time to plan and migrate. When we announce a model deprecation, we notify customers who are actively using the model by email and document the deprecation on this page.++Unless safety or compliance concerns require a faster timeline, we provide the following minimum notice periods before model retirement:++- Generally available models: At least 6 months.+- Specialized variants of generally available models: At least 3 months. Examples include chat variants such as `gpt-5.1-chat-latest`, Codex variants such as `gpt-5.3-codex`, and deep research variants such as `o3-deep-research`.+- Preview models: Preview models, identified by `preview` in the model name, may be retired with much shorter notice, such as 2 weeks. Examples include `computer-use-preview` and `gpt-4o-audio-preview`. We don't recommend using preview models for business-critical production workloads unless you can migrate on short notice.++If safety or compliance concerns require us to retire a model sooner, we will provide as much notice as reasonably possible.++These notice periods give customers time to evaluate recommended replacement models, test application behavior, and complete migrations before a model is no longer available. In some cases, developers may be able to provision dedicated capacity for continued access after a model's shutdown date. To explore this option, contact our sales team.+ ## Deprecation vs. legacy @@ -19,4 +33,50 @@ We use the term "legacy" to refer to models and endpoints that no longer receive Upcoming deprecations are listed below, with the most recent announcements at the top. +### 2026-06-03: Reusable prompts++On June 3, 2026, we notified developers using reusable prompts in the dashboard and API that reusable prompt objects are being deprecated.++| Date | Update |+|---|---|+| June 3, 2026 | Deprecation announced and prompt creation de-emphasized in the platform. |+| Nov 30, 2026 | The `v1/prompts` API and reusable prompt objects are scheduled to shut down. |++To migrate, move reusable prompt content into your application code. See Migrate from prompt objects.++### 2026-06-03: Evals platform++On June 3, 2026, we notified developers using the Evals platform that the product is being deprecated.++| Date | Update |+|---|---|+| June 3, 2026 | Deprecation announced for the Evals platform. |+| Oct 31, 2026 | Existing evals become read-only. |+| Nov 30, 2026 | The Evals dashboard and API are scheduled to shut down. |++Graders documented for eval workflows are part of this transition. Fine-tuning-related timelines remain covered in the self-serve fine-tuning section below.++See Moving from OpenAI Evals to Promptfoo for a migration path.++### 2026-06-03: Agent Builder++On June 3, 2026, we notified developers using Agent Builder that the product is being deprecated. ChatKit remains available.++| Date | Update |+|---|---|+| June 3, 2026 | Deprecation announced for Agent Builder. |+| Nov 30, 2026 | Agent Builder is scheduled to shut down. |++See Migrate from Agent Builder to continue with the Agents SDK or ChatGPT Workspace Agents.++### 2026-06-02: GPT Image model deprecations++On June 2, 2026, we notified developers using older GPT Image models of their deprecation and removal from the API on December 1, 2026.++| Shutdown date | Model / system | Recommended replacement |+|---|---|---|+| Dec 1, 2026 | `gpt-image-1-mini` | `gpt-image-2` |+| Dec 1, 2026 | `gpt-image-1.5` | `gpt-image-2` |+| Dec 1, 2026 | `chatgpt-image-latest` | `gpt-image-2` |+ ### 2026-05-08: gpt-5.2-chat-latest and gpt-5.3-chat-latest model snapshots