How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Overlays

An overlay is how you say something about somebody else's API contract without editing it. API Evangelist is a second author on 2299 providers' documents, and this is where that stays legible.

5550
overlays written
2299
providers annotated
17209
actions
0
of them remove anything

These are first-party artifacts

Providers did not write these overlays — API Evangelist did, to annotate their contracts without modifying them. Every one of the 17209 actions is an update; not one is a remove. Nothing this network adds can delete an operation, drop a server, or narrow a schema somebody else published.

How API Evangelist Uses Overlays

5,550 overlays across 2,299 providers, 17,209 actions, and not one of them removes anything.

OpenAPI Overlay Specification

A way to say something about somebody else's API contract without editing it.

Where the actions land

447 distinct JSONPath targets. $.info dominates, which is the right place for a second author to write — metadata beside the document's own metadata, rather than inside the operations a provider defined.

TargetActions
$.info8538
$1057
$.servers833
$.servers[0]275
$.components216
$.tags193
$.components.securitySchemes156
$.externalDocs143
$.components.securitySchemes.bearerAuth83
$.components.schemas.Error50
$.components.schemas48
$.servers[*]41
$.paths37
$.info.contact33
$.components.securitySchemes.ApiKeyAuth28
$.servers[0].variables.apiRoot22
$.components.securitySchemes.oauth221
$.paths.*.*21
$.components.securitySchemes.applicationPassword20
$.components.securitySchemes.OAuth220

The vocabulary they inject

3051 distinct x- keys across the corpus — the largest coherent extension vocabulary in the catalog, and one that has never been documented in one place. That is an authoring backlog, and it is ours.

Extension keyOccurrences
x-apievangelist-provider3501
x-apievangelist-artifacts1623
x-apievangelist-enriched1330
x-apievangelist-source1178
x-apievangelist-note1119
x-generated1087
x-method1087
x-apievangelist-conventions889
x-apievangelist-auth753
x-apievangelist-errors750
x-apievangelist694
x-source654
x-apievangelist-notes577
x-apievangelist-authentication569
x-apievangelist-harvested564
x-apievangelist-lifecycle413
x-agentic-access409
x-apievangelist-idempotency338
x-note335
x-authentication334
x-idempotency311
x-apievangelist-slug297
x-apievangelist-rating297
x-apievangelist-category251