Cvent · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Cvent REST Venue Profiles API

6 actions 6 updates phrasing extends openapi/cvent-venue-profiles-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Cvent's API. It is a proposal applied on top of the contract, not a document Cvent publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info

$.paths['/venues/{venueId}/details'].put

$.paths['/venues/{venueId}/details'].patch

$.paths['/venues/{venueId}/details/overview'].get

$.paths['/venues/{venueId}/facility'].put

$.paths['/venues/{venueId}/facility'].patch

OpenAPI Overlay

# 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 Venue Profiles API
  version: 1.0.0
extends: openapi/cvent-venue-profiles-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: 5
- target: $.paths['/venues/{venueId}/details'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a venue's profile details
      effect: write
      questions:
      - How do I overwrite all of a venue's profile details at once?
      - Does a full venue details update clear fields I leave out?
      instructions:
      - text: Replace venue {venueId}'s details with name {name}, type {type} and address {address}.
        slots:
          venueId: path.venueId
          name: requestBody.name
          type: requestBody.type
          address: requestBody.address
      - text: Fully rewrite the details of venue {venueId} including main phone {mainPhoneNumber}.
        slots:
          venueId: path.venueId
          mainPhoneNumber: requestBody.mainPhoneNumber
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/details'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a few venue details
      effect: write
      questions:
      - Can I update just a venue's website without resending everything?
      - Which venue details fields can I partially update with a merge patch?
      instructions:
      - text: Patch only the website of venue {venueId} to {websiteAddress}.
        slots:
          venueId: path.venueId
          websiteAddress: requestBody.websiteAddress
      - text: Partially update venue {venueId}'s cancellation policy to {cancellationPolicy}.
        slots:
          venueId: path.venueId
          cancellationPolicy: requestBody.cancellationPolicy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/details/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an overview of a venue's details
      effect: read
      questions:
      - What does my venue's profile currently say?
      - Can I get a summary of a venue's details?
      instructions:
      - text: Get the details overview for venue {venueId}.
        slots:
          venueId: path.venueId
      - text: Show a summary of venue {venueId}'s profile.
        slots:
          venueId: path.venueId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/facility'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a venue's facility information
      effect: write
      questions:
      - How do I overwrite all facility info, like meeting space and sleeping rooms, for a venue?
      - Which facility fields apply to my type of venue?
      instructions:
      - text: Replace venue {venueId}'s facility info with {numberOfMeetingRooms} meeting rooms and capacity {maximumCapacity}.
        slots:
          venueId: path.venueId
          numberOfMeetingRooms: requestBody.numberOfMeetingRooms
          maximumCapacity: requestBody.maximumCapacity
      - text: Fully rewrite the facility record for venue {venueId}, named {name}.
        slots:
          venueId: path.venueId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/venues/{venueId}/facility'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a few venue facility values
      effect: write
      questions:
      - Can I update only the year renovated for a venue's facility?
      - Is there a way to partially change facility rates without replacing everything?
      instructions:
      - text: Patch venue {venueId}'s facility to year renovated {yearRenovated}.
        slots:
          venueId: path.venueId
          yearRenovated: requestBody.yearRenovated
      - text: Partially update the single rate for venue {venueId} to {singleRate}.
        slots:
          venueId: path.venueId
          singleRate: requestBody.singleRate
      method: generated
      generated: '2026-09-26'