{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-deprecation-schema.json",
  "title": "Deprecation",
  "description": "A single active deprecation entry. See the Versioning and\ndeprecation section in `info.description` for notice-period rules.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/smarterweather-com-meta-api-openapi.yml#/components/schemas/Deprecation",
  "type": "object",
  "required": [
    "surface",
    "announced_at",
    "sunset_at",
    "migration"
  ],
  "properties": {
    "surface": {
      "type": "string",
      "description": "The deprecated surface, expressed as a stable identifier.\nCommon forms include an operation path (`/v1/weather`),\na parameter reference (`/v1/weather?param=foo`), or a\nresponse-field JSON Pointer (`/v1/weather#/current/feels_like`).\n"
    },
    "announced_at": {
      "type": "string",
      "format": "date",
      "description": "ISO 8601 date on which the deprecation was announced."
    },
    "sunset_at": {
      "type": "string",
      "format": "date",
      "description": "ISO 8601 date on or after which the deprecated surface may be\nremoved (minimum 90 days for shape changes, 6 months for\nendpoint removal).\n"
    },
    "migration": {
      "type": "string",
      "description": "Short prose pointer to the replacement surface or migration\nguide. Clients should treat this as documentation, not a\nmachine-parseable URL.\n"
    }
  }
}