# 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 Contact Research API
  version: 1.0.0
extends: openapi/seamless-ai-contact-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['/contacts/research'].post
  update:
    x-apievangelist-phrasing:
      intent: Enrich contacts with emails and phone numbers
      effect: write
      questions:
      - How do I get verified contact details for people I found in a contact search?
      - Can I enrich a person by name and company without running a search first?
      - Is there a way to check whether a contact has changed jobs?
      - Does each contact research request use up a credit?
      instructions:
      - text: Research the contacts from search results {searchResultIds}.
        slots:
          searchResultIds: requestBody.searchResultIds
      - text: 'Enrich these people by identity: {contacts}.'
        slots:
          contacts: requestBody.contacts
      - text: Run a job change research on contacts {contacts} with job change set to {isJobChange}.
        slots:
          contacts: requestBody.contacts
          isJobChange: requestBody.isJobChange
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/research/poll'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status and results of contact research
      effect: read
      questions:
      - How do I know when my contact research request is done?
      - Where do I fetch the enriched emails and phones after researching contacts?
      instructions:
      - text: Poll contact research requests {requestIds} for results.
        slots:
          requestIds: query.requestIds
      - text: Get the status of contact enrichment {requestIds}.
        slots:
          requestIds: query.requestIds
      method: generated
      generated: '2026-10-01'