Software Development

API Versioning Policy

Define the versioning and deprecation policy for an API - version scheme choice (URI path, header, date-based account-pinned, or deliberate no-versioning), a written breaking-change definition, deprecation notice windows by audience, sunset communication (RFC 9745 Deprecation and RFC 8594 Sunset headers), enforcement at the sunset date (fall-forward vs hard cutoff), and breaking-change governance, with REST version-and-sunset and GraphQL continuous schema evolution treated as separate policies. Use whenever the user mentions API versioning, /v2, breaking changes, deprecation, sunset dates, or migration windows - even if they never say "versioning policy". Client SDK versioning is plain SemVer and belongs to samber/developer-platform-skills@sdk-portfolio-strategy.

Publisher / source
samber/developer-platform-skills (found on skills.sh)
Upstream record
samber/developer-platform-skills
Version
Version 3
Published
Publication review
Approved for publication
Content fingerprint
08a337112d24edf5ccc1856045726eacdea22b787078ec327e90f20b568b2c62