# 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 Submit API
  version: 1.0.0
extends: openapi/apis-io-submit-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: 2
- target: $.paths['/api/v1/submit/discover'].get
  update:
    x-apievangelist-phrasing:
      intent: Discover a domain's API surface before submitting
      effect: read
      questions:
      - What API artifacts can be discovered on my domain before I submit it?
      - Does my site already have an apis.json or an api-catalog?
      instructions:
      - text: Discover the API surface of {url}.
        slots:
          url: query.url
      - text: Probe {url} for apis.json, OpenAPI and an api-catalog before submitting.
        slots:
          url: query.url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/submit'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit an API provider for review and listing
      effect: write
      questions:
      - How do I submit an API provider for review and listing?
      - What is the minimum I need to submit a provider?
      instructions:
      - text: Submit {name} for listing with contact {contact}.
        slots:
          name: requestBody.name
          contact: requestBody.contact
      - text: Submit {name} for review with apis.json {url}, notifying {contact}.
        slots:
          name: requestBody.name
          url: requestBody.url
          contact: requestBody.contact
      method: generated
      generated: '2026-09-26'