# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Web of Science Reviewer Locator API
  version: 1.0.0
extends: openapi/clarivate-web-of-science-reviewer-locator-api-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['/'].post
  update:
    x-apievangelist-phrasing:
      intent: Request reviewer recommendations
      effect: write
      questions:
      - How do I find expert peer reviewers for a manuscript?
      - Can I exclude certain reviewers or countries from recommendations?
      - Can I get reviewer suggestions for a grant application?
      instructions:
      - text: Find reviewers for the manuscript {searchArticle}.
        slots:
          searchArticle: requestBody.searchArticle
      - text: Recommend {numRecommendations} reviewers for {searchArticle}, excluding {excludedReviewers}.
        slots:
          numRecommendations: requestBody.numRecommendations
          searchArticle: requestBody.searchArticle
          excludedReviewers: requestBody.excludedReviewers
      - text: Suggest reviewers for {searchArticle} only from {includedCountries}.
        slots:
          searchArticle: requestBody.searchArticle
          includedCountries: requestBody.includedCountries
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{searchToken}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve reviewer recommendations by token
      effect: read
      questions:
      - How do I get the reviewer recommendations for a search I already submitted?
      - Can I fetch earlier reviewer results using the search token?
      instructions:
      - text: Get reviewer recommendations for search token {searchToken}.
        slots:
          searchToken: path.searchToken
      - text: Retrieve the reviewer list from earlier search {searchToken}.
        slots:
          searchToken: path.searchToken
      method: generated
      generated: '2026-10-01'