# 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 Meeting Request API
  version: 1.0.0
extends: openapi/cvent-event-cloud-meeting-request-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: 8
- target: $.paths['/events/{id}/meeting-requests'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the meeting request behind an event
      effect: read
      questions:
      - Which meeting request was an event created from?
      - How do I find the original meeting request connected to an event?
      instructions:
      - text: Get the meeting request connected to event {id}.
        slots:
          id: path.id
      - text: Show which meeting request event {id} came from.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms'].get
  update:
    x-apievangelist-phrasing:
      intent: List meeting request forms
      effect: read
      questions:
      - What meeting request forms are set up in my account?
      - Can I filter meeting request forms, for example to active ones?
      instructions:
      - text: List my meeting request forms.
      - text: List meeting request forms matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a meeting request form
      effect: read
      questions:
      - What questions and settings does a specific meeting request form have?
      - How do I retrieve one meeting request form by ID?
      instructions:
      - text: Get meeting request form {id}.
        slots:
          id: path.id
      - text: Show the setup of meeting request form {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms/{id}/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: List meeting requests submitted on a form
      effect: read
      questions:
      - Which meeting requests have been submitted through a given form?
      - Can I list requests on a form submitted after a certain date?
      instructions:
      - text: Show every request that came in through meeting request form {id}.
        slots:
          id: path.id
      - text: List meeting requests on form {id} submitted after {after}.
        slots:
          id: path.id
          after: query.after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms/{id}/requests'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update meeting requests on a form
      effect: write
      questions:
      - How do I add information to several existing meeting requests at once?
      - Can I update meeting requests without enforcing required question validation?
      instructions:
      - text: Bulk update the existing meeting requests on form {id}.
        slots:
          id: path.id
      - text: 'Update existing requests on form {id}, skipping required-question checks: {skipRequiredQuestionValidation}.'
        slots:
          id: path.id
          skipRequiredQuestionValidation: query.skipRequiredQuestionValidation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms/{id}/requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk create meeting requests on a form
      effect: write
      questions:
      - How do I submit new meeting requests into an active form from another system?
      - Can I create several meeting requests in one call, including room and budget requirements?
      instructions:
      - text: Create new meeting requests on active form {id}.
        slots:
          id: path.id
      - text: 'Submit a batch of new meeting requests to form {id}, skip required validation: {skipRequiredQuestionValidation}.'
        slots:
          id: path.id
          skipRequiredQuestionValidation: query.skipRequiredQuestionValidation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-request-forms/{id}/requests/{requestId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single meeting request
      effect: read
      questions:
      - What did the requester fill in on a specific meeting request?
      - How do I fetch one meeting request from a form?
      instructions:
      - text: Get meeting request {requestId} on form {id}.
        slots:
          requestId: path.requestId
          id: path.id
      - text: Show the answers in meeting request {requestId} from form {id}.
        slots:
          requestId: path.requestId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/meeting-requests/{requestId}/documents'].get
  update:
    x-apievangelist-phrasing:
      intent: List documents attached to a meeting request
      effect: read
      questions:
      - What documents were uploaded with a meeting request?
      - Can I get download reference links for a meeting request's documents?
      instructions:
      - text: List documents for meeting request {requestId}.
        slots:
          requestId: path.requestId
      - text: 'List meeting request {requestId}''s documents with reference links: {includeReferenceLink}.'
        slots:
          requestId: path.requestId
          includeReferenceLink: query.includeReferenceLink
      method: generated
      generated: '2026-09-26'