{
  "product": "AI Model Deprecation & Breaking-Change API",
  "schema_version": "1",
  "generated_at": "2026-06-17",
  "integrity": "QuotaLedger reports observed vendor deprecation data with a source and as_of date on every record. It never accepts payment to change, hide, reorder, or editorialize what the data says. No record carries a 'best' or 'recommended vendor' judgment; successor mappings are the vendor's own stated replacement.",
  "coverage": {
    "providers_covered": [
      "OpenAI",
      "Anthropic",
      "Google (Gemini API & Vertex AI)",
      "Azure OpenAI",
      "AWS Bedrock"
    ],
    "providers_roadmap": [
      "Mistral",
      "xAI"
    ],
    "note": "v1 seed covers the five providers with formal, dated deprecation/retirement pages. Mistral and xAI publish changes less formally and are on the coverage roadmap; they are intentionally omitted rather than guessed (accuracy is the moat)."
  },
  "policies": [
    {
      "provider": "AWS Bedrock",
      "policy": "Minimum 12 months from launch to end-of-life; a model stays in LEGACY at least 6 months before EOL. In LEGACY, existing callers keep access but inactive accounts (no call for 15+ days) and new customers may lose/lack access. At EOL the model is inaccessible in all Regions and invocations fail with a ValidationException.",
      "source_url": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
      "as_of": "2026-06-17"
    },
    {
      "provider": "Anthropic",
      "policy": "Four-stage lifecycle: Active -> Legacy -> Deprecated -> Retired. Anthropic has committed to preserving retired model weights and aims to make some past models available again in future.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    }
  ],
  "deprecations": [
    {
      "id": "openai-assistants-api",
      "provider": "OpenAI",
      "platform": "OpenAI API",
      "item": "Assistants API",
      "type": "api",
      "status": "deprecated",
      "shutdown_date": "2026-08-26",
      "successor": "Responses API + Conversations API",
      "migration_note": "Move thread/run orchestration to the Responses API and conversation state to the Conversations API before shutdown.",
      "source_url": "https://developers.openai.com/api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "openai-dalle-2-3",
      "provider": "OpenAI",
      "platform": "OpenAI API",
      "item": "DALL·E 2 and DALL·E 3",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-05-12",
      "successor": "gpt-image-1-mini (image generation consolidated onto the gpt-image line; see gpt-image-2)",
      "migration_note": "Image generation moved to the gpt-image family.",
      "source_url": "https://developers.openai.com/api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "openai-gpt-image-legacy",
      "provider": "OpenAI",
      "platform": "OpenAI API",
      "item": "gpt-image-1-mini, gpt-image-1.5, chatgpt-image-latest",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-12-01",
      "successor": "gpt-image-2",
      "migration_note": "Repoint image-generation calls to gpt-image-2.",
      "source_url": "https://developers.openai.com/api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "openai-gpt5-o3-snapshots",
      "provider": "OpenAI",
      "platform": "OpenAI API",
      "item": "Older GPT-5 and o3 model snapshots",
      "type": "model",
      "status": "deprecated",
      "announced_date": "2026-06-11",
      "shutdown_date": "2026-12-11",
      "successor": "Current GPT-5 / o3 snapshots",
      "migration_note": "Pin to a current snapshot id before the shutdown date.",
      "source_url": "https://developers.openai.com/api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-opus",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3 Opus",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-01-05",
      "successor": "Claude Opus 4.x",
      "migration_note": "Migrate to a current Opus model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-sonnet",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3 Sonnet",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2025-07-21",
      "successor": "Claude Sonnet 4.x",
      "migration_note": "Migrate to a current Sonnet model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-haiku",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3 Haiku",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-04-20",
      "successor": "Claude Haiku 4.5",
      "migration_note": "Migrate to a current Haiku model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-sonnet-4-opus-4",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude Sonnet 4 and Claude Opus 4",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-06-15",
      "successor": "Claude Sonnet 4.6 / Claude Opus 4.8",
      "migration_note": "Sonnet 4 -> Sonnet 4.6; Opus 4 -> Opus 4.8.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-opus-4-1",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude Opus 4.1",
      "type": "model",
      "status": "deprecated",
      "announced_date": "2026-06-05",
      "shutdown_date": "2026-08-05",
      "successor": "Claude Opus 4.8",
      "migration_note": "Migrate to Claude Opus 4.8 before shutdown.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-gemini-2-5",
      "provider": "Google",
      "platform": "Gemini API / Vertex AI",
      "item": "Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-10-16",
      "shutdown_note": "Earliest shutdown 2026-10-16 per Google's deprecation table. Google gives advance notice of the exact date.",
      "successor": "Gemini 3 (gemini-3.1-pro-preview / gemini-3.5-flash / gemini-3.1-flash-lite)",
      "migration_note": "Gemini 2.5 Pro, Flash and Flash-Lite now carry a firm earliest shutdown of 2026-10-16 on Google's deprecation table (Gemini 3 is GA). Migrate to Gemini 3 models before then.",
      "source_url": "https://ai.google.dev/gemini-api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-vertex-genai-sdk",
      "provider": "Google",
      "platform": "Vertex AI",
      "item": "Vertex AI SDK modules: generative_models, language_models, vision_models, tuning, caching",
      "type": "sdk",
      "status": "deprecated",
      "announced_date": "2025-06-24",
      "shutdown_date": "2026-06-24",
      "successor": "Google Gen AI SDK (google-genai)",
      "migration_note": "Replace vertexai.generative_models / language_models / vision_models / tuning / caching imports with the Google Gen AI SDK (google-genai) before removal; all five modules are removed together on the shutdown date.",
      "source_url": "https://docs.cloud.google.com/vertex-ai/generative-ai/docs/release-notes",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-vertex-extensions",
      "provider": "Google",
      "platform": "Vertex AI",
      "item": "Vertex AI Extensions",
      "type": "api",
      "status": "deprecated",
      "shutdown_date": "2026-11-26",
      "shutdown_note": "Shut down after 2026-11-26.",
      "successor": "Gemini Enterprise Agent Platform",
      "migration_note": "Migrate Extensions workloads to the Agent Platform.",
      "source_url": "https://docs.cloud.google.com/vertex-ai/generative-ai/docs/release-notes",
      "as_of": "2026-06-17"
    },
    {
      "id": "azure-gpt-4o-mini",
      "provider": "Azure OpenAI",
      "platform": "Azure OpenAI",
      "item": "GPT-4o-mini",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-02-27",
      "successor": "Current Foundry models (e.g. gpt-4.1-mini)",
      "migration_note": "Redeploy to a supported model in Microsoft Foundry.",
      "source_url": "https://learn.microsoft.com/en-us/azure/ai-foundry/openai/concepts/model-retirements",
      "as_of": "2026-06-17"
    },
    {
      "id": "azure-gpt-4o-2024-05-08",
      "provider": "Azure OpenAI",
      "platform": "Azure OpenAI",
      "item": "GPT-4o versions 2024-05-13 and 2024-08-06",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-03-31",
      "successor": "Later GPT-4o / GPT-4.1",
      "migration_note": "Redeploy to a supported model by the retirement date. Existing fine-tuned deployments continue for an additional year.",
      "source_url": "https://learn.microsoft.com/en-us/azure/ai-foundry/openai/concepts/model-retirements",
      "as_of": "2026-06-17"
    },
    {
      "id": "azure-gpt-4o-2024-11-20",
      "provider": "Azure OpenAI",
      "platform": "Azure OpenAI",
      "item": "GPT-4o version 2024-11-20",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-06-03",
      "successor": "GPT-4.1",
      "migration_note": "Redeploy to a supported model.",
      "source_url": "https://learn.microsoft.com/en-us/azure/ai-foundry/openai/concepts/model-retirements",
      "as_of": "2026-06-17"
    },
    {
      "id": "azure-gpt-4-1",
      "provider": "Azure OpenAI",
      "platform": "Azure OpenAI",
      "item": "GPT-4.1",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-10-14",
      "successor": "Current Foundry models",
      "migration_note": "Plan redeployment before the retirement date.",
      "source_url": "https://learn.microsoft.com/en-us/azure/ai-foundry/openai/concepts/model-retirements",
      "as_of": "2026-06-17"
    },
    {
      "id": "bedrock-claude-3-7-sonnet",
      "provider": "AWS Bedrock",
      "platform": "AWS Bedrock",
      "item": "Claude 3.7 Sonnet (on Bedrock)",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-04-28",
      "successor": "Current Claude models on Bedrock",
      "migration_note": "EOL on Bedrock: invocations now fail with a ValidationException. Switch to a current Claude model id.",
      "source_url": "https://docs.aws.amazon.com/bedrock/latest/userguide/model-lifecycle.html",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-gemini-2-0-flash",
      "provider": "Google",
      "platform": "Gemini API / Vertex AI",
      "item": "Gemini 2.0 Flash and Flash-Lite (gemini-2.0-flash, gemini-2.0-flash-001, gemini-2.0-flash-lite, gemini-2.0-flash-lite-001)",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-06-01",
      "successor": "Gemini 2.5 Flash / Gemini 2.5 Flash-Lite",
      "migration_note": "The Gemini 2.0 Flash family shut down 2026-06-01. Move to Gemini 2.5 Flash (or Flash-Lite).",
      "source_url": "https://ai.google.dev/gemini-api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-imagen-4",
      "provider": "Google",
      "platform": "Gemini API / Vertex AI",
      "item": "Imagen 4.0 (imagen-4.0-generate-001, imagen-4.0-ultra-generate-001, imagen-4.0-fast-generate-001)",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-06-24",
      "successor": "gemini-3-pro-image-preview or gemini-2.5-flash-image",
      "migration_note": "Imagen 4.0 GA image models have an earliest shutdown of 2026-06-24. Migrate image generation to Gemini 3 Pro Image (preview) or Gemini 2.5 Flash Image.",
      "source_url": "https://ai.google.dev/gemini-api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-gemini-embedding-001",
      "provider": "Google",
      "platform": "Gemini API",
      "item": "gemini-embedding-001 (text embeddings)",
      "type": "model",
      "status": "deprecated",
      "shutdown_date": "2026-07-14",
      "successor": "No successor announced yet",
      "migration_note": "Google's deprecation table lists gemini-embedding-001 with an earliest shutdown of 2026-07-14 and no published replacement yet. Track the release notes before relying on it long-term.",
      "source_url": "https://ai.google.dev/gemini-api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "google-text-embedding-004",
      "provider": "Google",
      "platform": "Gemini API",
      "item": "text-embedding-004",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-01-14",
      "successor": "gemini-embedding-001",
      "migration_note": "text-embedding-004 shut down 2026-01-14. Migrate embeddings to gemini-embedding-001.",
      "source_url": "https://ai.google.dev/gemini-api/docs/deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-5-sonnet",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3.5 Sonnet (claude-3-5-sonnet-20240620, claude-3-5-sonnet-20241022)",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2025-10-28",
      "successor": "Claude Sonnet 4.6",
      "migration_note": "Both Claude 3.5 Sonnet snapshots were retired 2025-10-28 on the Anthropic API. Migrate to a current Sonnet model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-5-haiku",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3.5 Haiku (claude-3-5-haiku-20241022)",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-02-19",
      "successor": "Claude Haiku 4.5",
      "migration_note": "Claude 3.5 Haiku was retired 2026-02-19 on the Anthropic API. Migrate to a current Haiku model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    },
    {
      "id": "anthropic-claude-3-7-sonnet",
      "provider": "Anthropic",
      "platform": "Anthropic API",
      "item": "Claude 3.7 Sonnet (claude-3-7-sonnet-20250219)",
      "type": "model",
      "status": "retired",
      "shutdown_date": "2026-02-19",
      "successor": "Claude Sonnet 4.6",
      "migration_note": "Claude 3.7 Sonnet was retired 2026-02-19 on the Anthropic API. (Amazon Bedrock set its own date; see the Bedrock record.) Migrate to a current Sonnet model.",
      "source_url": "https://platform.claude.com/docs/en/about-claude/model-deprecations",
      "as_of": "2026-06-17"
    }
  ]
}