# Public deprecation policy

Apilyn v1 follows the API changelog and deprecation policy in
`docs/api/CHANGELOG_POLICY.md`.

## Summary

- `/v1` is the stable namespace for v1 customers and generated SDKs.
- Additive changes may ship in `/v1` when existing clients can safely ignore
  them.
- Breaking changes require a new major namespace, such as `/v2`, unless a
  documented security exception is approved.
- Deprecated endpoints/fields/events remain available for at least 180 days for
  generally available v1 features.
- Deprecation notices must include OpenAPI metadata, changelog entry, migration
  path, sunset date and telemetry plan that avoids document content, secrets and
  raw bearer tokens.

## Launch state

No v1 public endpoints, fields or webhook events are deprecated at launch
readiness. Deferred enterprise prompts D01-D06 are not deprecated v1 features;
they are trigger-gated future work.