{
  "current": "v1",
  "currentRelease": "1.0.0",
  "unversionedAlias": {
    "basePath": "/api",
    "pinnedTo": "v1",
    "note": "/api/... is a permanent alias for /api/v1/... and is never repointed at a later major version."
  },
  "versions": [
    {
      "version": "v1",
      "status": "current",
      "release": "1.0.0",
      "basePath": "/api/v1",
      "specUrl": "https://murugappan.dev/openapi.json",
      "releasedOn": "2026-08-25",
      "deprecatedOn": null,
      "sunsetOn": null,
      "successor": null,
      "url": "https://murugappan.dev/api/v1"
    }
  ],
  "policy": {
    "scheme": "url-path",
    "deprecationNoticeDays": 180,
    "rules": [
      "The version is a path segment: every endpoint lives under /api/v1. There is no version header and no version query parameter — the URL is the version.",
      "The unversioned /api/... prefix is a permanent alias for v1 and will never be repointed at a later major version. Code against either; both keep answering v1 for as long as v1 exists.",
      "Additive changes ship inside a version without notice: new endpoints, new optional request fields, new response fields. Ignore fields you do not know rather than rejecting them.",
      "Breaking changes never ship inside a version. Removing or renaming a field or endpoint, changing a field's type, narrowing an enum, or changing what a status code means all require a new path version.",
      "A deprecated version answers every request with a Deprecation header (RFC 9745), a Sunset header (RFC 8594), and Link relations of deprecation and successor-version. At least 180 days pass between the first Deprecation header and the Sunset date.",
      "Every response carries API-Version (the release being served) and API-Supported-Versions. /api/v1/versions is the machine-readable form of this policy and is also reachable at /api/versions.",
      "After sunset a version answers 410 Gone with the standard error envelope, pointing at its successor. Paths are never silently reused."
    ],
    "documentationUrl": "https://murugappan.dev/developers/#versioning",
    "headers": {
      "API-Version": "The semantic release that answered this request.",
      "API-Supported-Versions": "Every path version this deployment still answers.",
      "Deprecation": "RFC 9745. Present only on a deprecated version; the date it was deprecated.",
      "Sunset": "RFC 8594. Present only on a deprecated version; the date it stops answering.",
      "Link": "RFC 8288 relations: version-history, latest-version, service-desc, service-doc, and deprecation plus successor-version once deprecated."
    }
  }
}