Sunset headers, deprecation warnings, usage monitoring, and 410 Gone after sunset date.
API Deprecation
# 1. Sunset header (RFC 8594)
Sunset: Sat, 31 Dec 2025 23:59:59 GMT
Deprecation: true
Link: ; rel="successor-version"
# 2. Deprecation warning in response
{
"data": {...},
"_deprecation": {
"message": "This endpoint is removed 2025-12-31",
"sunset": "2025-12-31",
"replacement":"GET /v2/users"
}
}
# 3. After sunset: return 410 Gone
{"error":"GONE","message":"Use /v2/users"}
# 4. Log deprecated usage to find clients to contact