Product & Business

Major API Version Upgrade Timeline

Product Management diagram · made in Skemio

Timeline for API deprecation: 1. Dual-Run Launch, 2. Sunset Headers, 3. Brownout Drills, 4. Hard Decommission.
Timeline for API deprecation: 1. Dual-Run Launch, 2. Sunset Headers, 3. Brownout Drills, 4. Hard Decommission.

What it shows

  • Release v2 specs and migration SDKs at least 6 months before cut-off.
  • Sunset warnings must appear directly inside HTTP response headers.
  • Brownout drills intentionally trigger temporary errors to wake up stale callers.

The takeaway

Brownouts surface sleeping API clients in daylight, long before the final shutdown breaks them.

More product management diagrams