# Creative Vietnam API Versioning, Deprecation & Sunset Policy

This document formalizes Creative Vietnam's API lifecycle and stability commitments for autonomous agents.

## 1. Versioning Strategy
All Creative Vietnam REST endpoints use URI-based SemVer versioning (e.g., `/api/v1/*`). Breaking schema changes will always introduce a new major version prefix (`/api/v2/`).

## 2. Deprecation Schedule
- **Grace Period**: Creative Vietnam guarantees a minimum of **180 days** advance notice before any API endpoint or operation is sunset.
- **RFC 8594 Compliance**: When an endpoint is slated for retirement, responses will carry `Deprecation: true`, a `Sunset` timestamp header, and a `Link` header referencing migration docs.

## 3. Current Lifetime
- Current API Version: `v1` (Active & Stable)
- Sunset Target: `2028-12-31 23:59:59 GMT`