{
  "schemaVersion": "notify.template.api-deprecation@1",
  "templateId": "api-deprecation-slack",
  "tenantId": "_system",
  "channelType": "slack",
  "key": "api.deprecation.announced",
  "locale": "en-US",
  "subject": null,
  "description": "Slack notification template for API deprecation announcements",
  "body": ":warning: *API Deprecation Notice*\n\n*Service:* `{{service}}`\n*Endpoint:* `{{method}} {{path}}`\n{{#operationId}}*Operation:* `{{operationId}}`\n{{/operationId}}\n*Deprecated:* {{deprecatedAt}}\n*Sunset Date:* {{sunsetAt}} ({{daysUntilSunset}} days remaining)\n\n{{#reason}}*Reason:* {{reason}}\n{{/reason}}\n{{#successorPath}}*Replacement:* `{{successorPath}}`\n{{/successorPath}}\n{{#migrationGuide}}:book: <{{migrationGuide}}|Migration Guide>\n{{/migrationGuide}}{{#changelogUrl}}:page_facing_up: <{{changelogUrl}}|Changelog>\n{{/changelogUrl}}\n\n_Please update your integrations before the sunset date._",
  "renderMode": "markdown",
  "format": "slack",
  "metadata": {
    "priority": "high",
    "category": "api-governance",
    "tags": ["deprecation", "api", "migration"]
  },
  "placeholders": [
    { "name": "service", "description": "Service name owning the deprecated endpoint", "example": "authority", "required": true },
    { "name": "path", "description": "API path of the deprecated endpoint", "example": "/v1/tokens", "required": true },
    { "name": "method", "description": "HTTP method", "example": "POST", "required": true },
    { "name": "operationId", "description": "OpenAPI operation ID", "example": "createToken", "required": false },
    { "name": "deprecatedAt", "description": "When the endpoint was deprecated", "example": "2025-01-15", "required": true },
    { "name": "sunsetAt", "description": "When the endpoint will be removed", "example": "2025-07-15", "required": true },
    { "name": "daysUntilSunset", "description": "Days remaining until sunset", "example": "180", "required": true },
    { "name": "reason", "description": "Deprecation reason", "example": "Replaced by v2 endpoint", "required": false },
    { "name": "successorPath", "description": "Replacement endpoint path", "example": "/v2/tokens", "required": false },
    { "name": "migrationGuide", "description": "URL to migration documentation", "example": "https://docs.stella-ops.org/migration/tokens-v2", "required": false },
    { "name": "changelogUrl", "description": "URL to the changelog entry", "example": "https://docs.stella-ops.org/changelog#2025-01-15", "required": false }
  ],
  "createdBy": "api-governance-guild",
  "createdAt": "2025-12-11T00:00:00Z",
  "updatedBy": "api-governance-guild",
  "updatedAt": "2025-12-11T00:00:00Z"
}