# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Io Search API
  version: 1.0.0
extends: openapi/apis-io-search-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: 3
- target: $.paths['/search/apis'].get
  update:
    x-apievangelist-phrasing:
      intent: Search APIs by keyword
      effect: read
      questions:
      - Can I search every API by a keyword or phrase?
      - What APIs come up for a simple keyword search?
      instructions:
      - text: Search APIs for {search}.
        slots:
          search: query.search
      - text: Run a keyword search for {search}, {limit} results per page.
        slots:
          search: query.search
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/search/apis'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit an APIs.json to the search index
      effect: write
      questions:
      - How do I submit my APIs.json file to be included?
      - What fields does an APIs.json submission need?
      instructions:
      - text: Submit the APIs.json at {url} for {name}, described as {description}.
        slots:
          url: requestBody.url
          name: requestBody.name
          description: requestBody.description
      - text: Add {name} to the search index from its APIs.json at {url} with description {description}.
        slots:
          name: requestBody.name
          url: requestBody.url
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search across APIs, providers, tags and artifacts
      effect: read
      questions:
      - Can I search across APIs, providers, tags and artifacts in one query?
      - Which messaging APIs ship an OpenAPI, returning just the spec and pricing artifacts?
      - Can I get providers back from a search instead of APIs?
      instructions:
      - text: Search for {return} matching {q}.
        slots:
          return: query.return
          q: query.q
      - text: Search APIs tagged {tags} that publish {artifact_types}.
        slots:
          tags: query.tags
          artifact_types: query.artifact_types
      - text: Search within {providers} for APIs in band {band}.
        slots:
          providers: query.providers
          band: query.band
      method: generated
      generated: '2026-09-26'