{
  "policy_version": "1.0.0",
  "current_version": "v1",
  "version_style": "URL path (/api/v1/...)",
  "version_header": "X-API-Version",
  "documentation": "https://apostle.company/api#versioning",
  "guarantees": [
    "Additive changes (new endpoints, new optional fields) ship inside v1 without notice.",
    "Breaking changes ship as a new path prefix (/api/v2/...); v1 keeps responding."
  ],
  "deprecation": {
    "signal_headers": [
      "Deprecation",
      "Sunset"
    ],
    "current_state": "Deprecation: false. v1 is current and has no sunset date.",
    "notice_period_days": 180,
    "process": [
      "A deprecated version starts returning a Deprecation header with the deprecation date and a Sunset header with the removal date.",
      "The Link header carries rel=\"deprecation-policy\" pointing at this document.",
      "This document and https://apostle.company/api#versioning list the sunset date for at least 180 days before removal.",
      "Agents should treat any Sunset header as a hard cutoff and migrate to the newest version listed in current_version."
    ]
  },
  "contact": "hello@apostle.company"
}