APIs.io · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for APIs.io Artifact Types API

21 actions 21 updates phrasing extends openapi/apis-io-artifact-types-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for APIs.io's API. It is a proposal applied on top of the contract, not a document APIs.io publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 21 · first 16 shown; the file carries all of them

$.info

$.paths['/openapis'].get

$.paths['/asyncapis'].get

$.paths['/arazzo'].get

$.paths['/postman'].get

$.paths['/collections'].get

$.paths['/graphql'].get

$.paths['/json-schemas'].get

$.paths['/json-structures'].get

$.paths['/json-ld'].get

$.paths['/rules'].get

$.paths['/examples'].get

$.paths['/finops'].get

$.paths['/plans'].get

$.paths['/rate-limits'].get

$.paths['/channels'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for APIs.io Artifact Types API
  version: 1.0.0
extends: openapi/apis-io-artifact-types-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 20
- target: $.paths['/openapis'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse OpenAPI definitions across providers
      effect: read
      questions:
      - Which providers have published OpenAPI definitions in the catalog?
      - Can I get every OpenAPI spec tagged payments, with the spec bodies inlined?
      instructions:
      - text: List OpenAPI definitions published by {providers}.
        slots:
          providers: query.providers
      - text: Find OpenAPI specs across the catalog tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/asyncapis'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse AsyncAPI definitions across providers
      effect: read
      questions:
      - Which providers publish AsyncAPI documents for their event-driven APIs?
      - How do I find AsyncAPI specs about a topic like payments or IoT?
      instructions:
      - text: List AsyncAPI documents matching {q}.
        slots:
          q: query.q
      - text: Show the AsyncAPI specs from {providers} with their content inlined.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/arazzo'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse Arazzo workflow documents
      effect: read
      questions:
      - Are there any Arazzo workflows published for multi-step API flows?
      - Which providers describe their integrations as Arazzo workflows?
      instructions:
      - text: List Arazzo workflows tagged {tags}.
        slots:
          tags: query.tags
      - text: Find Arazzo workflow documents from {providers}.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/postman'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse Postman collections across providers
      effect: read
      questions:
      - Which APIs have a Postman collection I can import?
      - Can I search Postman collections by keyword?
      instructions:
      - text: List Postman collections for {providers}.
        slots:
          providers: query.providers
      - text: Find Postman collections matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/collections'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse generic API collection artifacts
      effect: read
      questions:
      - What request collections, other than Postman ones, are in the catalog?
      - Which providers publish a generic API collection artifact?
      instructions:
      - text: List the non-Postman API collection artifacts tagged {tags}.
        slots:
          tags: query.tags
      - text: Show generic API collections from {providers}.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/graphql'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse GraphQL schemas across providers
      effect: read
      questions:
      - Which providers publish a GraphQL schema?
      - How do I find GraphQL schemas about commerce or content?
      instructions:
      - text: List GraphQL schemas from {providers}.
        slots:
          providers: query.providers
      - text: Find GraphQL schemas matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/json-schemas'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse JSON Schema definitions across providers
      effect: read
      questions:
      - Where can I find JSON Schema definitions published by API providers?
      - Can I pull JSON Schema files tagged with a domain like healthcare?
      instructions:
      - text: List JSON Schema definitions tagged {tags} across providers.
        slots:
          tags: query.tags
      - text: Find JSON Schema files in the catalog matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/json-structures'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse JSON Structure definitions
      effect: read
      questions:
      - Which providers publish JSON Structure definitions?
      - Can I search JSON Structure documents by keyword?
      instructions:
      - text: List JSON Structure definitions from {providers}.
        slots:
          providers: query.providers
      - text: Find JSON Structure documents matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/json-ld'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse JSON-LD contexts
      effect: read
      questions:
      - Are there JSON-LD contexts in the catalog for linked-data vocabularies?
      - Which providers publish a JSON-LD context?
      instructions:
      - text: List JSON-LD contexts matching {q}.
        slots:
          q: query.q
      - text: Show JSON-LD contexts tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse API governance rulesets
      effect: read
      questions:
      - Which providers publish Spectral rulesets or other governance rules?
      - How do I find API linting rules tagged for security?
      instructions:
      - text: List governance rulesets from {providers}.
        slots:
          providers: query.providers
      - text: Find Spectral and governance rules matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/examples'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse published API code examples
      effect: read
      questions:
      - Where can I find code examples published for an API?
      - Can I get example artifacts for a specific provider with their content?
      instructions:
      - text: List code examples from {providers} with content inlined.
        slots:
          providers: query.providers
      - text: Find API examples tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/finops'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse FinOps artifacts across providers
      effect: read
      questions:
      - Which providers publish FinOps artifacts about API cost?
      - Can I search FinOps documents across the catalog by keyword?
      instructions:
      - text: List FinOps artifacts matching {q}.
        slots:
          q: query.q
      - text: Show FinOps artifacts from {providers}.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/plans'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse providers' published API plans
      effect: read
      questions:
      - Which providers publish their API plans as a structured artifact?
      - How do I pull the published plan documents for APIs tagged messaging?
      instructions:
      - text: List the published plans for {providers}.
        slots:
          providers: query.providers
      - text: Find provider plan artifacts tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rate-limits'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse providers' published rate limits
      effect: read
      questions:
      - What rate limits do providers publish for their APIs?
      - Can I find rate-limit artifacts for a particular provider?
      instructions:
      - text: List the rate-limit artifacts for {providers}.
        slots:
          providers: query.providers
      - text: Find published rate limits matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/channels'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse AsyncAPI event channels
      effect: read
      questions:
      - Which event channels or streaming topics can I subscribe to across providers?
      - Can I search individual AsyncAPI channels rather than whole specs?
      instructions:
      - text: List event channels tagged {tags}.
        slots:
          tags: query.tags
      - text: Find AsyncAPI channels matching {q} with each channel's spec inlined.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/mcp'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse published MCP servers
      effect: read
      questions:
      - Which providers publish an MCP server?
      - How do I find MCP servers for tools in a given domain?
      instructions:
      - text: List MCP servers from {providers}.
        slots:
          providers: query.providers
      - text: Find MCP servers matching {q} and include their server cards.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/skills'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse published Agent Skills
      effect: read
      questions:
      - Which providers have published Agent Skills?
      - Can I search Agent Skills by topic across the catalog?
      instructions:
      - text: List Agent Skills tagged {tags}.
        slots:
          tags: query.tags
      - text: Find Agent Skills matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scopes'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse OAuth scope sets
      effect: read
      questions:
      - What OAuth scopes do providers define for their APIs?
      - How do I look up the published scope set for a given provider?
      instructions:
      - text: List OAuth scope sets for {providers}.
        slots:
          providers: query.providers
      - text: Find OAuth scopes matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'
- target: $.paths['/security'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse security scheme definitions
      effect: read
      questions:
      - Which providers publish authentication schemes, a VDP or a trust center?
      - Can I search security scheme definitions by keyword?
      instructions:
      - text: List security scheme definitions for {providers}.
        slots:
          providers: query.providers
      - text: Find security and auth definitions tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apis-json'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse APIs.json indexes
      effect: read
      questions:
      - Which APIs in the catalog have an APIs.json self-description?
      - Can I get APIs.json documents inlined for a given provider?
      instructions:
      - text: List APIs.json indexes from {providers} with the documents inlined.
        slots:
          providers: query.providers
      - text: Find APIs.json files matching {q}.
        slots:
          q: query.q
      method: generated
      generated: '2026-09-26'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/apis-io-artifact-types-api-phrasing-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.