# 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 Synthesis API
  version: 1.0.0
extends: openapi/apis-io-synthesis-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: 6
- target: $.paths['/compare'].get
  update:
    x-apievangelist-phrasing:
      intent: Compare providers side by side
      effect: read
      questions:
      - How do two providers compare on facets and artifact coverage?
      - Which provider leads each facet when I compare several?
      instructions:
      - text: Compare {providers} on score and artifact coverage.
        slots:
          providers: query.providers
      - text: Put providers {providers} side by side.
        slots:
          providers: query.providers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gaps'].get
  update:
    x-apievangelist-phrasing:
      intent: Analyze artifact and score gaps for providers
      effect: read
      questions:
      - What high-value artifacts does a provider lack that its peers publish?
      - Where are the gaps across a stack of providers?
      instructions:
      - text: Run a gap analysis for {providers}.
        slots:
          providers: query.providers
      - text: Show gaps for {providers} with a minimum peer share of {min_share}.
        slots:
          providers: query.providers
          min_share: query.min_share
      method: generated
      generated: '2026-09-26'
- target: $.paths['/changes'].get
  update:
    x-apievangelist-phrasing:
      intent: See what changed in the catalog since a date
      effect: read
      questions:
      - What providers were added or updated in the catalog since a date?
      - Which ratings moved since a given day?
      instructions:
      - text: Show what changed in the catalog since {since}.
        slots:
          since: query.since
      - text: List providers added or updated since {since}.
        slots:
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stack'].get
  update:
    x-apievangelist-phrasing:
      intent: Design a recommended API stack
      effect: read
      questions:
      - What is the best-rated provider for each capability in a stack I need?
      - Can I design an API stack for payments, email and identity?
      instructions:
      - text: Recommend a stack for {capabilities}.
        slots:
          capabilities: query.capabilities
      - text: Design an API stack for {capabilities} preferring {region}.
        slots:
          capabilities: query.capabilities
          region: query.region
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gaps/industry/{slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find artifact gaps across an industry
      effect: read
      questions:
      - Which artifact types do most providers in an industry lack?
      - Where is a whole vertical under-served on MCP or Arazzo?
      instructions:
      - text: Show artifact gaps across the {slug} industry.
        slots:
          slug: path.slug
      - text: Find what most providers in industry {slug} lack.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/stack/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a designed stack as APIs.json
      effect: read
      questions:
      - Can I get a designed stack as an APIs.json I can commit?
      - How do I export my recommended stack with an Arazzo hint?
      instructions:
      - text: Export a stack for {capabilities} as APIs.json.
        slots:
          capabilities: query.capabilities
      - text: Export the APIs.json for a {capabilities} stack in {region}.
        slots:
          capabilities: query.capabilities
          region: query.region
      method: generated
      generated: '2026-09-26'