# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cvent REST Travel RFPs API
  version: 1.0.0
extends: openapi/cvent-travel-rfps-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: 9
- target: $.paths['/travel-programs'].get
  update:
    x-apievangelist-phrasing:
      intent: List travel programs
      effect: read
      questions:
      - Which corporate travel programs do we run hotel RFPs for?
      - Can I filter travel programs updated since a certain date?
      instructions:
      - text: List my travel programs.
      - text: Show travel programs matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-programs/questions'].get
  update:
    x-apievangelist-phrasing:
      intent: List questions across all travel programs
      effect: read
      questions:
      - What RFP questions are used across all our travel programs?
      - Can I pull every travel program question in one list?
      instructions:
      - text: List questions across all travel programs.
      - text: Show all travel program questions changed after {after}.
        slots:
          after: query.after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-programs/{programId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one travel program
      effect: read
      questions:
      - What are the details of a specific travel program?
      - Can I look up a travel program by its ID?
      instructions:
      - text: Get travel program {programId}.
        slots:
          programId: path.programId
      - text: Show the details of travel program {programId}.
        slots:
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-programs/{programId}/questions'].get
  update:
    x-apievangelist-phrasing:
      intent: List questions for one travel program
      effect: read
      questions:
      - Which questions does one particular travel program ask hotels?
      - Can I see only the questions attached to a single program?
      instructions:
      - text: List the questions for travel program {programId}.
        slots:
          programId: path.programId
      - text: Show program {programId}'s RFP questions.
        slots:
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-programs/{programId}/questions/{questionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one travel program question
      effect: read
      questions:
      - What does a specific question in a travel program ask?
      - Can I fetch one travel program question by ID?
      instructions:
      - text: Get question {questionId} in travel program {programId}.
        slots:
          questionId: path.questionId
          programId: path.programId
      - text: Show the wording of question {questionId} from program {programId}.
        slots:
          questionId: path.questionId
          programId: path.programId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-proposals'].get
  update:
    x-apievangelist-phrasing:
      intent: List travel proposals
      effect: read
      questions:
      - Which hotel proposals have come in for our travel programs?
      - Can I filter travel proposals by date?
      instructions:
      - text: List travel proposals.
      - text: Show travel proposals matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-proposals/bids'].get
  update:
    x-apievangelist-phrasing:
      intent: List travel proposal bids
      effect: read
      questions:
      - What bids have hotels submitted on travel proposals?
      - Can I list proposal bids received since a given date?
      instructions:
      - text: List travel proposal bids.
      - text: Show proposal bids received after {after}.
        slots:
          after: query.after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-proposals/bids/{travelProposalBidId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one travel proposal bid
      effect: read
      questions:
      - What rates did a hotel offer in a specific bid?
      - Can I look up a single travel proposal bid by ID?
      instructions:
      - text: Get travel proposal bid {travelProposalBidId}.
        slots:
          travelProposalBidId: path.travelProposalBidId
      - text: Show the details of bid {travelProposalBidId}.
        slots:
          travelProposalBidId: path.travelProposalBidId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/travel-proposals/{travelProposalId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one travel proposal
      effect: read
      questions:
      - What's in a specific hotel's travel proposal?
      - Can I retrieve a travel proposal by its ID?
      instructions:
      - text: Get travel proposal {travelProposalId}.
        slots:
          travelProposalId: path.travelProposalId
      - text: Show the full travel proposal {travelProposalId}.
        slots:
          travelProposalId: path.travelProposalId
      method: generated
      generated: '2026-09-26'