{ "schemaVersion": "notify.template.api-deprecation@1", "templateId": "api-deprecation-email", "tenantId": "_system", "channelType": "email", "key": "api.deprecation.announced", "locale": "en-US", "subject": "[StellaOps] API Deprecation Notice: {{method}} {{path}} ({{service}})", "description": "Email notification template for API deprecation announcements", "body": "\n\n\n \n\n\n
\n
\n ⚠️\n

API Deprecation Notice

\n
\n
\n
\n Service:\n {{service}}\n
\n
\n Endpoint:\n {{method}} {{path}}\n
\n {{#operationId}}\n
\n Operation:\n {{operationId}}\n
\n {{/operationId}}\n
\n Deprecated:\n {{deprecatedAt}}\n
\n
\n Sunset Date: {{sunsetAt}}
\n {{daysUntilSunset}} days remaining\n
\n {{#reason}}\n
\n Reason:\n

{{reason}}

\n
\n {{/reason}}\n {{#successorPath}}\n
\n Replacement Endpoint:\n {{successorPath}}\n
\n {{/successorPath}}\n
\n {{#migrationGuide}}Migration Guide{{/migrationGuide}}\n {{#changelogUrl}}View Changelog{{/changelogUrl}}\n
\n
\n

Please update your integrations before the sunset date to avoid service disruption.

\n

This is an automated notification from StellaOps API Governance.

\n
\n
\n
\n\n", "renderMode": "html", "format": "email", "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" }