# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Seamless Ai Company Research API
  version: 1.0.0
extends: openapi/seamless-ai-company-research-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/companies/research'].post
  update:
    x-apievangelist-phrasing:
      intent: Enrich companies with full research data
      effect: write
      questions:
      - How do I enrich a company I found in search results to get its full profile?
      - Can I research a company directly by its domain without searching for it first?
      - Does researching a company I already enriched recently cost another credit?
      instructions:
      - text: Research the companies behind search results {searchResultIds}.
        slots:
          searchResultIds: requestBody.searchResultIds
      - text: 'Enrich these companies by domain or name: {companies}.'
        slots:
          companies: requestBody.companies
      - text: Re-research {companies} even if I enriched them recently, skipping the duplicate check {skipDeduplicationCheck}.
        slots:
          companies: requestBody.companies
          skipDeduplicationCheck: requestBody.skipDeduplicationCheck
      method: generated
      generated: '2026-10-01'
- target: $.paths['/companies/research/poll'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status and results of company research
      effect: read
      questions:
      - How can I tell whether my company research request has finished?
      - Where do I pick up the enriched company data after submitting a research request?
      instructions:
      - text: Poll company research requests {requestIds} for their results.
        slots:
          requestIds: query.requestIds
      - text: Check whether company research {requestIds} is complete yet.
        slots:
          requestIds: query.requestIds
      method: generated
      generated: '2026-10-01'