naftiko: 1.0.0-alpha2
info:
  label: Cvent REST APIs — Meeting Request
  description: 'Cvent REST APIs — Meeting Request. 8 operations. Lead operation: Get MR by Event ID. Self-contained Naftiko capability covering one business surface.'
  tags:
  - Cvent
  - Meeting Request
  created: '2026-05-20'
  modified: '2026-05-20'
binds:
- namespace: env
  keys:
    CVENT_API_KEY: CVENT_API_KEY
capability:
  consumes:
  - type: http
    namespace: rest-meeting-request
    baseUri: https://api-platform.cvent.com/ea
    description: Cvent REST APIs — Meeting Request business capability. Self-contained, no shared references.
    resources:
    - name: events-id-meeting-requests
      path: /events/{id}/meeting-requests
      operations:
      - name: getmeetingrequestbyeventid
        method: GET
        description: Get MR by Event ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: ID of an event.
          required: true
    - name: meeting-request-forms
      path: /meeting-request-forms
      operations:
      - name: listmrf
        method: GET
        description: List MR Forms
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: 'A filter query string narrows search results and supports the combination of logical and comparison operators. The filter adheres to the pattern filter=''field'' comparisonType ''value''.

            This is the comp'
    - name: meeting-request-forms-id
      path: /meeting-request-forms/{id}
      operations:
      - name: getmrfbyid
        method: GET
        description: Get MR Form
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: Path parameter id.
          required: true
    - name: meeting-request-forms-id-requests
      path: /meeting-request-forms/{id}/requests
      operations:
      - name: createmeetingrequest
        method: POST
        description: Create MR (Bulk)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: skipRequiredQuestionValidation
          in: query
          type: boolean
          description: Flag `true` to skip required field validation.
        - name: id
          in: path
          type: string
          description: Path parameter id.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: updatemeetingrequest
        method: PUT
        description: Update MR (Bulk)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: skipRequiredQuestionValidation
          in: query
          type: boolean
          description: Flag `true` to skip required field validation.
        - name: id
          in: path
          type: string
          description: Path parameter id.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: listmeetingrequest
        method: GET
        description: List MR
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: 'A filter query string narrows search results and supports the combination of logical and comparison operators. The filter adheres to the pattern filter=''field'' comparisonType ''value''.

            These are the co'
        - name: id
          in: path
          type: string
          description: Path parameter id.
          required: true
    - name: meeting-request-forms-id-requests-requestid
      path: /meeting-request-forms/{id}/requests/{requestId}
      operations:
      - name: getmeetingrequestbyid
        method: GET
        description: Get MR
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requestId
          in: path
          type: string
          description: Path parameter requestId.
          required: true
        - name: id
          in: path
          type: string
          description: Path parameter id.
          required: true
    - name: meeting-requests-requestid-documents
      path: /meeting-requests/{requestId}/documents
      operations:
      - name: listmeetingrequestdocuments
        method: GET
        description: List MR Documents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: The maximum number of Documents that can be fetched at once.
        - name: includeReferenceLink
          in: query
          type: boolean
          description: Set to `false` to exclude the field `referenceLink` from the response.
        - name: filter
          in: query
          type: string
          description: 'A filter query string narrows search results and supports the combination of logical and comparison operators. The filter adheres to the pattern filter=''field'' comparisonType ''value''.


            The following c'
        - name: requestId
          in: path
          type: string
          description: Path parameter requestId.
          required: true
  exposes:
  - type: rest
    namespace: rest-meeting-request-rest
    port: 8080
    description: REST adapter for Cvent REST APIs — Meeting Request. One resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/events/{id}/meeting-requests
      name: events-id-meeting-requests
      description: REST surface for events-id-meeting-requests.
      operations:
      - method: GET
        name: getmeetingrequestbyeventid
        description: Get MR by Event ID
        call: rest-meeting-request.getmeetingrequestbyeventid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meeting-request-forms
      name: meeting-request-forms
      description: REST surface for meeting-request-forms.
      operations:
      - method: GET
        name: listmrf
        description: List MR Forms
        call: rest-meeting-request.listmrf
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meeting-request-forms/{id}
      name: meeting-request-forms-id
      description: REST surface for meeting-request-forms-id.
      operations:
      - method: GET
        name: getmrfbyid
        description: Get MR Form
        call: rest-meeting-request.getmrfbyid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meeting-request-forms/{id}/requests
      name: meeting-request-forms-id-requests
      description: REST surface for meeting-request-forms-id-requests.
      operations:
      - method: POST
        name: createmeetingrequest
        description: Create MR (Bulk)
        call: rest-meeting-request.createmeetingrequest
        with:
          skipRequiredQuestionValidation: rest.skipRequiredQuestionValidation
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatemeetingrequest
        description: Update MR (Bulk)
        call: rest-meeting-request.updatemeetingrequest
        with:
          skipRequiredQuestionValidation: rest.skipRequiredQuestionValidation
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listmeetingrequest
        description: List MR
        call: rest-meeting-request.listmeetingrequest
        with:
          filter: rest.filter
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meeting-request-forms/{id}/requests/{requestId}
      name: meeting-request-forms-id-requests-requestid
      description: REST surface for meeting-request-forms-id-requests-requestid.
      operations:
      - method: GET
        name: getmeetingrequestbyid
        description: Get MR
        call: rest-meeting-request.getmeetingrequestbyid
        with:
          requestId: rest.requestId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/meeting-requests/{requestId}/documents
      name: meeting-requests-requestid-documents
      description: REST surface for meeting-requests-requestid-documents.
      operations:
      - method: GET
        name: listmeetingrequestdocuments
        description: List MR Documents
        call: rest-meeting-request.listmeetingrequestdocuments
        with:
          limit: rest.limit
          includeReferenceLink: rest.includeReferenceLink
          filter: rest.filter
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: rest-meeting-request-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cvent REST APIs — Meeting Request. One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: cvent-getmeetingrequestbyeventid
      description: Get MR by Event ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.getmeetingrequestbyeventid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-listmrf
      description: List MR Forms
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.listmrf
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getmrfbyid
      description: Get MR Form
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.getmrfbyid
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-createmeetingrequest
      description: Create MR (Bulk)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: rest-meeting-request.createmeetingrequest
      with:
        skipRequiredQuestionValidation: tools.skipRequiredQuestionValidation
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-updatemeetingrequest
      description: Update MR (Bulk)
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: rest-meeting-request.updatemeetingrequest
      with:
        skipRequiredQuestionValidation: tools.skipRequiredQuestionValidation
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-listmeetingrequest
      description: List MR
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.listmeetingrequest
      with:
        filter: tools.filter
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-getmeetingrequestbyid
      description: Get MR
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.getmeetingrequestbyid
      with:
        requestId: tools.requestId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: cvent-listmeetingrequestdocuments
      description: List MR Documents
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: rest-meeting-request.listmeetingrequestdocuments
      with:
        limit: tools.limit
        includeReferenceLink: tools.includeReferenceLink
        filter: tools.filter
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.