x-mux-doc-decorators-deprecated-enum-values
`x-mux-doc-decorators-deprecated-enum-values` appears on schema objects and properties. Its value is a list. Used by a single provider across 1 OpenAPI document. It sits in the `x-mux-` namespace, so its meaning is defined by mux tooling rather than by OpenAPI. Consistent with change management — this is inferred from where the key appears and what it carries, not from any published definition.
Where it appears
| Location in the document | Occurrences | |
|---|---|---|
| schema | 7 |
What its value looks like
| Value shape | Occurrences |
|---|---|
| array | 7 |
Providers publishing it
All 1.
Why this is not in OpenAPI
Extensions exist because a provider needed something the specification would not carry. Most of what they hold is not the API contract at all — it is operational metadata about the contract: documentation, lifecycle, policy, provenance, and now agents. That metadata is usually better placed alongside the contract, in an Overlay or an APIs.json index, than crammed inside it. See everything else doing the change management job.