Stable and preview operations
Every operation is either stable or preview. A stable operation is the launch surface: build on it. A preview operation ships and works, but it is not a commitment. It may change shape or be removed without notice.
Where you see it
Section titled “Where you see it”The marker is one field on the operation, and everything you read derives from it, so nothing disagrees:
| Where | What it shows |
|---|---|
| API reference | Every preview operation is also listed under the Preview (unstable) tag, with [Preview] before its summary and a one-sentence warning first in its description. |
| OpenAPI document | x-nicia-stability: preview on the operation. Stable operations carry no such field. |
| TypeScript client | stability on the operation in the generated manifest, and a @preview line in the hover documentation of the method and its types. |
| These docs | A Preview aside on every section that documents a preview operation. |
What is preview today
Section titled “What is preview today”- Durable branches. Every operation that forks, reads, writes, plans a merge for, archives, restores or destroys an experiment branch.
- Governed definitions. Inspecting, proposing and reviewing inferred definitions.
- Part of the change lifecycle. Selecting a subset of a change, scheduling and cancelling one, and reading its journal.
Everything else is stable: documents, records, statements, context, query and search, changes with approve, reject and publish, receipts, the schema, and keys.