Deprecation policy

When an API version is being retired, Simwood signals it programmatically so you can detect and migrate ahead of time. This policy applies uniformly across every service.

Deprecation headers

A deprecated version includes these response headers:

Deprecation: true
Sunset: 2027-06-01
Link: <https://api.simwood.com/{service}/v2>; rel="successor-version"

• Deprecation — the version is deprecated.
• Sunset — the date after which the version may stop responding.
• Link with rel="successor-version" — where to migrate.

Watch for these headers in your client so you can surface deprecation warnings automatically rather than discovering a sunset by outage.

Support window

A deprecated version is supported for a minimum of 12 months after its successor is published, giving you time to migrate.