Cvent REST APIs — Housing

naftiko: 1.0.0-alpha2
info:
  label: Cvent REST APIs — Housing
  description: 'Cvent REST APIs — Housing. 21 operations. Lead operation: Get Housing Events Summaries. Self-contained Naftiko capability covering one business surface.'
  tags:
  - Cvent
  - Housing
  created: '2026-05-20'
  modified: '2026-05-20'
binds:
- namespace: env
  keys:
    CVENT_API_KEY: CVENT_API_KEY
capability:
  consumes:
  - type: http
    namespace: rest-housing
    baseUri: https://api-platform.cvent.com/ea
    description: Cvent REST APIs — Housing business capability. Self-contained, no shared references.
    resources:
    - name: connections
      path: /connections
      operations:
      - name: createconnection
        method: POST
        description: Create Connection
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: housing-events-summaries
      path: /housing-events/summaries
      operations:
      - name: gethousingeventssummaries
        method: GET
        description: Get Housing Events Summaries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: housing-events-housingeventid
      path: /housing-events/{housingEventId}
      operations:
      - name: gethousingeventinfo
        method: GET
        description: Get Housing Event Info
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
    - name: housing-events-housingeventid-hotels
      path: /housing-events/{housingEventId}/hotels
      operations:
      - name: gethousingeventhotels
        method: GET
        description: Get Housing Event Hotels
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
    - name: housing-events-housingeventid-hotels-hotelid
      path: /housing-events/{housingEventId}/hotels/{hotelId}
      operations:
      - name: gethousingeventhotel
        method: GET
        description: Get Housing Event Hotel
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
        - name: hotelId
          in: path
          type: string
          description: Path parameter hotelId.
          required: true
    - name: housing-events-housingeventid-hotels-hotelid-available-night
      path: /housing-events/{housingEventId}/hotels/{hotelId}/available-nights
      operations:
      - name: gethousingeventhotelavailability
        method: GET
        description: Get Event Hotel Availability
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
        - name: hotelId
          in: path
          type: string
          description: Path parameter hotelId.
          required: true
    - name: housing-events-housingeventid-hotels-hotelid-room-types
      path: /housing-events/{housingEventId}/hotels/{hotelId}/room-types
      operations:
      - name: gethousingeventroomtypes
        method: GET
        description: Get Housing Event Room Types
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
        - name: hotelId
          in: path
          type: string
          description: Path parameter hotelId.
          required: true
    - name: housing-events-housingeventid-hotels-hotelid-room-types-room
      path: /housing-events/{housingEventId}/hotels/{hotelId}/room-types/{roomTypeId}
      operations:
      - name: getroomtypedetails
        method: GET
        description: Get Room Type Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: roomTypeId
          in: path
          type: string
          description: Path parameter roomTypeId.
          required: true
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
        - name: hotelId
          in: path
          type: string
          description: Path parameter hotelId.
          required: true
    - name: housing-events-housingeventid-hotels-hotelid-room-types-room
      path: /housing-events/{housingEventId}/hotels/{hotelId}/room-types/{roomTypeId}/inventory
      operations:
      - name: getroomtypeinventory
        method: GET
        description: Get Room Type Inventory
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: roomTypeId
          in: path
          type: string
          description: Path parameter roomTypeId.
          required: true
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
        - name: hotelId
          in: path
          type: string
          description: Path parameter hotelId.
          required: true
    - name: housing-events-housingeventid-inventory
      path: /housing-events/{housingEventId}/inventory
      operations:
      - name: gethousingeventinventory
        method: GET
        description: Get Housing Event Inventory
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
    - name: housing-events-housingeventid-reservations
      path: /housing-events/{housingEventId}/reservations
      operations:
      - name: gethousingeventreservations
        method: GET
        description: Get Housing Event Reservations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: housingEventId
          in: path
          type: string
          description: Path parameter housingEventId.
          required: true
    - name: reservation-requests
      path: /reservation-requests
      operations:
      - name: createreservationrequest
        method: POST
        description: Create Reservation Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: reservation-requests-reservationrequestsid
      path: /reservation-requests/{reservationRequestsId}
      operations:
      - name: getreservationrequest
        method: GET
        description: Get Reservation Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationRequestsId
          in: path
          type: string
          description: Path parameter reservationRequestsId.
          required: true
      - name: updatereservationrequest
        method: PUT
        description: Update Reservation Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationRequestsId
          in: path
          type: string
          description: Path parameter reservationRequestsId.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: cancelreservationrequest
        method: DELETE
        description: Cancel Reservation Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationRequestsId
          in: path
          type: string
          description: Path parameter reservationRequestsId.
          required: true
    - name: reservation-requests-reservationrequestsid-reservations-rese
      path: /reservation-requests/{reservationRequestsId}/reservations/{reservationId}
      operations:
      - name: linkreservation
        method: POST
        description: Link Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationId
          in: path
          type: string
          description: Path parameter reservationId.
          required: true
        - name: reservationRequestsId
          in: path
          type: string
          description: Path parameter reservationRequestsId.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: unlinkreservation
        method: DELETE
        description: Unlink Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationId
          in: path
          type: string
          description: Path parameter reservationId.
          required: true
        - name: reservationRequestsId
          in: path
          type: string
          description: Path parameter reservationRequestsId.
          required: true
    - name: reservations
      path: /reservations
      operations:
      - name: createreservation
        method: POST
        description: Create Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: reservations-reservationid
      path: /reservations/{reservationId}
      operations:
      - name: getreservation
        method: GET
        description: Get Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationId
          in: path
          type: string
          description: Path parameter reservationId.
          required: true
      - name: cancelreservation
        method: DELETE
        description: Cancel Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationId
          in: path
          type: string
          description: Path parameter reservationId.
          required: true
      - name: updatereservationsync
        method: PUT
        description: Update Reservation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reservationId
          in: path
          type: string
          description: Path parameter reservationId.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: rest-housing-rest
    port: 8080
    description: REST adapter for Cvent REST APIs — Housing. One resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/connections
      name: connections
      description: REST surface for connections.
      operations:
      - method: POST
        name: createconnection
        description: Create Connection
        call: rest-housing.createconnection
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/summaries
      name: housing-events-summaries
      description: REST surface for housing-events-summaries.
      operations:
      - method: GET
        name: gethousingeventssummaries
        description: Get Housing Events Summaries
        call: rest-housing.gethousingeventssummaries
        with: {}
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}
      name: housing-events-housingeventid
      description: REST surface for housing-events-housingeventid.
      operations:
      - method: GET
        name: gethousingeventinfo
        description: Get Housing Event Info
        call: rest-housing.gethousingeventinfo
        with:
          housingEventId: rest.housingEventId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels
      name: housing-events-housingeventid-hotels
      description: REST surface for housing-events-housingeventid-hotels.
      operations:
      - method: GET
        name: gethousingeventhotels
        description: Get Housing Event Hotels
        call: rest-housing.gethousingeventhotels
        with:
          housingEventId: rest.housingEventId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels/{hotelId}
      name: housing-events-housingeventid-hotels-hotelid
      description: REST surface for housing-events-housingeventid-hotels-hotelid.
      operations:
      - method: GET
        name: gethousingeventhotel
        description: Get Housing Event Hotel
        call: rest-housing.gethousingeventhotel
        with:
          housingEventId: rest.housingEventId
          hotelId: rest.hotelId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels/{hotelId}/available-nights
      name: housing-events-housingeventid-hotels-hotelid-available-night
      description: REST surface for housing-events-housingeventid-hotels-hotelid-available-night.
      operations:
      - method: GET
        name: gethousingeventhotelavailability
        description: Get Event Hotel Availability
        call: rest-housing.gethousingeventhotelavailability
        with:
          housingEventId: rest.housingEventId
          hotelId: rest.hotelId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels/{hotelId}/room-types
      name: housing-events-housingeventid-hotels-hotelid-room-types
      description: REST surface for housing-events-housingeventid-hotels-hotelid-room-types.
      operations:
      - method: GET
        name: gethousingeventroomtypes
        description: Get Housing Event Room Types
        call: rest-housing.gethousingeventroomtypes
        with:
          housingEventId: rest.housingEventId
          hotelId: rest.hotelId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels/{hotelId}/room-types/{roomTypeId}
      name: housing-events-housingeventid-hotels-hotelid-room-types-room
      description: REST surface for housing-events-housingeventid-hotels-hotelid-room-types-room.
      operations:
      - method: GET
        name: getroomtypedetails
        description: Get Room Type Details
        call: rest-housing.getroomtypedetails
        with:
          roomTypeId: rest.roomTypeId
          housingEventId: rest.housingEventId
          hotelId: rest.hotelId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/hotels/{hotelId}/room-types/{roomTypeId}/inventory
      name: housing-events-housingeventid-hotels-hotelid-room-types-room
      description: REST surface for housing-events-housingeventid-hotels-hotelid-room-types-room.
      operations:
      - method: GET
        name: getroomtypeinventory
        description: Get Room Type Inventory
        call: rest-housing.getroomtypeinventory
        with:
          roomTypeId: rest.roomTypeId
          housingEventId: rest.housingEventId
          hotelId: rest.hotelId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/inventory
      name: housing-events-housingeventid-inventory
      description: REST surface for housing-events-housingeventid-inventory.
      operations:
      - method: GET
        name: gethousingeventinventory
        description: Get Housing Event Inventory
        call: rest-housing.gethousingeventinventory
        with:
          housingEventId: rest.housingEventId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/housing-events/{housingEventId}/reservations
      name: housing-events-housingeventid-reservations
      description: REST surface for housing-events-housingeventid-reservations.
      operations:
      - method: GET
        name: gethousingeventreservations
        description: Get Housing Event Reservations
        call: rest-housing.gethousingeventreservations
        with:
          housingEventId: rest.housingEventId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reservation-requests
      name: reservation-requests
      description: REST surface for reservation-requests.
      operations:
      - method: POST
        name: createreservationrequest
        description: Create Reservation Request
        call: rest-housing.createreservationrequest
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reservation-requests/{reservationRequestsId}
      name: reservation-requests-reservationrequestsid
      description: REST surface for reservation-requests-reservationrequestsid.
      operations:
      - method: GET
        name: getreservationrequest
        description: Get Reservation Request
        call: rest-housing.getreservationrequest
        with:
          reservationRequestsId: rest.reservationRequestsId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatereservationrequest
        description: Update Reservation Request
        call: rest-housing.updatereservationrequest
        with:
          reservationRequestsId: rest.reservationRequestsId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: cancelreservationrequest
        description: Cancel Reservation Request
        call: rest-housing.cancelreservationrequest
        with:
          reservationRequestsId: rest.reservationRequestsId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reservation-requests/{reservationRequestsId}/reservations/{reservationId}
      name: reservation-requests-reservationrequestsid-reservations-rese
      description: REST surface for reservation-requests-reservationrequestsid-reservations-rese.
      operations:
      - method: POST
        name: linkreservation
        description: Link Reservation
        call: rest-housing.linkreservation
        with:
          reservationId: rest.reservationId
          reservationRequestsId: rest.reservationRequestsId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: unlinkreservation
        description: Unlink Reservation
        call: rest-housing.unlinkreservation
        with:
          reservationId: rest.reservationId
          reservationRequestsId: rest.reservationRequestsId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reservations
      name: reservations
      description: REST surface for reservations.
      operations:
      - method: POST
        name: createreservation
        description: Create Reservation
        call: rest-housing.createreservation
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/reservations/{reservationId}
      name: reservations-reservationid
      description: REST surface for reservations-reservationid.
      operations:
      - method: GET
        name: getreservation
        description: Get Reservation
        call: rest-housing.getreservation
        with:
          reservationId: rest.reservationId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: cancelreservation
        description: Cancel Reservation
        call: rest-housing.cancelreservation
        with:
          reservationId: rest.reservationId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatereservationsync
        description: Update Reservation
        call: rest-housing.updatereservationsync
        with:
          reservationId: rest.reservationId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rest-housing-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cvent REST APIs — Housing. One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: cvent-createconnection
      description: Create Connection
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-housing.createconnection
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventssummaries
      description: Get Housing Events Summaries
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventssummaries
      with: {}
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventinfo
      description: Get Housing Event Info
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventinfo
      with:
        housingEventId: tools.housingEventId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventhotels
      description: Get Housing Event Hotels
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventhotels
      with:
        housingEventId: tools.housingEventId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventhotel
      description: Get Housing Event Hotel
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventhotel
      with:
        housingEventId: tools.housingEventId
        hotelId: tools.hotelId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventhotelavailability
      description: Get Event Hotel Availability
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventhotelavailability
      with:
        housingEventId: tools.housingEventId
        hotelId: tools.hotelId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventroomtypes
      description: Get Housing Event Room Types
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventroomtypes
      with:
        housingEventId: tools.housingEventId
        hotelId: tools.hotelId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getroomtypedetails
      description: Get Room Type Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.getroomtypedetails
      with:
        roomTypeId: tools.roomTypeId
        housingEventId: tools.housingEventId
        hotelId: tools.hotelId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getroomtypeinventory
      description: Get Room Type Inventory
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.getroomtypeinventory
      with:
        roomTypeId: tools.roomTypeId
        housingEventId: tools.housingEventId
        hotelId: tools.hotelId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventinventory
      description: Get Housing Event Inventory
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventinventory
      with:
        housingEventId: tools.housingEventId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-gethousingeventreservations
      description: Get Housing Event Reservations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.gethousingeventreservations
      with:
        housingEventId: tools.housingEventId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-createreservationrequest
      description: Create Reservation Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-housing.createreservationrequest
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getreservationrequest
      description: Get Reservation Request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.getreservationrequest
      with:
        reservationRequestsId: tools.reservationRequestsId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-updatereservationrequest
      description: Update Reservation Request
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: rest-housing.updatereservationrequest
      with:
        reservationRequestsId: tools.reservationRequestsId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-cancelreservationrequest
      description: Cancel Reservation Request
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: rest-housing.cancelreservationrequest
      with:
        reservationRequestsId: tools.reservationRequestsId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-linkreservation
      description: Link Reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-housing.linkreservation
      with:
        reservationId: tools.reservationId
        reservationRequestsId: tools.reservationRequestsId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-unlinkreservation
      description: Unlink Reservation
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: rest-housing.unlinkreservation
      with:
        reservationId: tools.reservationId
        reservationRequestsId: tools.reservationRequestsId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-createreservation
      description: Create Reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-housing.createreservation
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getreservation
      description: Get Reservation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-housing.getreservation
      with:
        reservationId: tools.reservationId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-cancelreservation
      description: Cancel Reservation
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: rest-housing.cancelreservation
      with:
        reservationId: tools.reservationId
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-updatereservationsync
      description: Update Reservation
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: rest-housing.updatereservationsync
      with:
        reservationId: tools.reservationId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.