# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for .io APIs API
  version: 1.0.0
extends: openapi/apis-io-apis-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: 5
- target: $.paths['/apis'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse and filter APIs across the catalog
      effect: read
      questions:
      - Which APIs in the catalog are tagged both payments and webhooks?
      - Can I list only the APIs that publish an AsyncAPI or an MCP server?
      - Is there a way to narrow APIs to one industry or region and sort them by score?
      instructions:
      - text: List APIs tagged {tags} across every provider.
        slots:
          tags: query.tags
      - text: Show APIs in the {industry} industry with a composite score of at least {min_score}.
        slots:
          industry: query.industry
          min_score: query.min_score
      - text: Find APIs matching {q} that publish {artifact_types}.
        slots:
          q: query.q
          artifact_types: query.artifact_types
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apis/{aid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the catalog record for one API
      effect: read
      questions:
      - What does the catalog record say about a single API, looked up by its aid?
      - Can I pull one API's record with selected artifact bodies inlined?
      instructions:
      - text: Get the API record for {aid}.
        slots:
          aid: path.aid
      - text: Fetch API {aid} with the content of its {artifact_types} artifacts inlined.
        slots:
          aid: path.aid
          artifact_types: query.artifact_types
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apis/{aid}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List one API's artifacts grouped by type
      effect: read
      questions:
      - What artifacts has a single API registered, grouped by type with counts?
      - Does this particular API have a Postman collection or a rules file on record?
      instructions:
      - text: Show the artifacts registered for API {aid}, grouped by type.
        slots:
          aid: path.aid
      - text: List every artifact of API {aid} with its body inlined.
        slots:
          aid: path.aid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apis/{aid}/similar'].get
  update:
    x-apievangelist-phrasing:
      intent: Find APIs similar to a given API
      effect: read
      questions:
      - What other APIs are like this one, based on the tags they share?
      - Can I get a short list of APIs comparable to one I already use?
      instructions:
      - text: Find APIs similar to {aid}.
        slots:
          aid: path.aid
      - text: Show the {limit} APIs most like {aid}.
        slots:
          limit: query.limit
          aid: path.aid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/openapis/{aid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an API's primary OpenAPI definition
      effect: read
      questions:
      - Where is the primary OpenAPI definition for a given API?
      - Can I download the OpenAPI spec body for one API instead of just its URL?
      instructions:
      - text: Get the primary OpenAPI URL for API {aid}.
        slots:
          aid: path.aid
      - text: Fetch the full primary OpenAPI document for {aid} inline.
        slots:
          aid: path.aid
      method: generated
      generated: '2026-09-26'