API lifecycle
Every operation in the generated reference has an x-lifecycle value.
| State | Meaning | Integration guidance |
|---|---|---|
| Stable | Active owner contract with compatibility guarantees for this version | Safe for production after tenant activation and conformance testing |
| Preview | Implemented, but the owner contract is draft or rollout proof remains | Pilot only; pin your integration and review release notes |
| Deprecated | Accepted only during a migration window | Move before the removal date |
Current v1 projection:
- stable: catalog schema/product sync, reconciliation, assistant bootstrap, public-chat runtime, signed webhook ingress;
- preview: direct search and managed product media.
A live route is not automatically stable. Stability follows the owner contract, tests, and rollout proof.