Data & schema semantics · Defaults & examples

x-default-description

`x-default-description` appears on parameter objects. Its value is a string. Used by a single provider across 149 OpenAPI documents. Observed values include `null`, `The default value depends upon `sortBy`, and`, `Assumes the MySQL Server default value, which may depend on the server`, `The default value is null.`. Consistent with defaults & examples — this is inferred from where the key appears and what it carries, not from any published definition.

Data & schema semantics derived description
How this description was produced. It is assembled from what was measured in the corpus — where this key appears in a document, what shape its value takes, the values observed, and how many providers use it. It is not taken from a published definition, because for most extensions none exists. Read it as evidence, not as a specification. If you own this extension and want it described properly, tell us.
4594 occurrences
149 documents
1 providers
purpose-named

Where it appears

Location in the documentOccurrences
parameter 2991
schema 658
operation 938
requestBody 3
other 3
header 1

What its value looks like

Value shapeOccurrences
string4557
integer6
array6
boolean14
empty11

Observed values

Sampled from the specifications, most frequent first.

nullThe default value depends upon `sortBy`, andAssumes the MySQL Server default value, which may depend on the serverThe default value is null.timeCreatedfalseThe default is null, which means that this property is not updated.Returns all lifecycle states by default

Providers publishing it

All 1.

oracle

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 data & schema semantics job.