Documentation & DX

x-apievangelist-note

`x-apievangelist-note` appears in the info block. Its value is a structured object. Used by 7 providers across 7 OpenAPI documents. Consistent with documentation & dx — this is inferred from where the key appears and what it carries, not from any published definition.

Documentation & DX 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.
This one is ours. API Evangelist wrote this key into its own copies of provider specifications. It is shown for completeness — the catalog is not exempt from its own inventory.
7 occurrences
7 documents
7 providers
purpose-named

Where it appears

Location in the documentOccurrences
root 1
info 5
operation 1

What its value looks like

Value shapeOccurrences
object6
string1

Observed values

Sampled from the specifications, most frequent first.

Derived from live HAL discovery + docs; not published by Artsy as OpenAPI.

Providers publishing it

All 7.

alterestateartgamefliphighrisejustyokrispnapkinai

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 documentation & dx job.