Deprecation policy

How we announce, schedule, and enforce breaking changes across the platform and API.

Deprecation policy

Breaking changes are rare and communicated early to reduce surprises.

Notifications

• Deprecations are announced in the blog and changelog with timelines.
• API responses may include Deprecation headers for affected endpoints.

Timelines

• Non-breaking additions ship immediately.
• Breaking removals provide at least 30 days' notice; 60 days for API contract changes.

Deprecation: https://diffmon.example.com/changelog/api-schema-change
Sunset: Wed, 01 Jul 2026 00:00:00 GMT

Customer actions

• Update SDK versions regularly to pick up warnings.
• Monitor the audit log for actions taken during migration windows.