# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Partner Service V2Prospects API
  version: 1.0.0
extends: openapi/explorium-v2prospects-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: 3
- target: $.paths['/v2/prospects/match'].post
  update:
    x-apievangelist-phrasing:
      intent: Match people to prospect IDs (v2)
      effect: read
      questions:
      - How do I resolve names, emails or LinkedIn URLs to prospect IDs in v2?
      - Can I match a list of people to IDs in one request?
      instructions:
      - text: Match {prospects_to_match} to prospect IDs.
        slots:
          prospects_to_match: requestBody.prospects_to_match
      - text: Resolve the prospect ID of each person in {prospects_to_match}.
        slots:
          prospects_to_match: requestBody.prospects_to_match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects'].post
  update:
    x-apievangelist-phrasing:
      intent: Search prospects by filters (v2)
      effect: read
      questions:
      - Which people match my target job titles and seniority?
      - Can I page through prospect search results with a cursor?
      instructions:
      - text: Find prospects matching {filters}.
        slots:
          filters: requestBody.filters
      - text: Search people with {filters}, {page_size} per page.
        slots:
          filters: requestBody.filters
          page_size: requestBody.page_size
      - text: Continue the prospect search from cursor {next_cursor}.
        slots:
          next_cursor: requestBody.next_cursor
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/prospects/stats'].post
  update:
    x-apievangelist-phrasing:
      intent: Count prospects matching filters (v2)
      effect: read
      questions:
      - How many people match my persona filters?
      - Can I size a prospect audience before fetching it?
      instructions:
      - text: Count prospects matching {filters}.
        slots:
          filters: requestBody.filters
      - text: Size the people segment defined by {filters}.
        slots:
          filters: requestBody.filters
      method: generated
      generated: '2026-10-01'