Wufoo REST API — Comments

naftiko: "1.0.0-alpha2"

info:
  label: "Wufoo REST API — Comments"
  description: >-
    Comments surface of the Wufoo REST API v3. 2 operations. Lead operation: List
    Form Comments. Self-contained Naftiko capability covering one Wufoo business
    surface.
  tags:
    - Wufoo
    - Comments
    - Collaboration
  created: "2026-05-23"
  modified: "2026-05-23"

binds:
  - namespace: env
    keys:
      WUFOO_SUBDOMAIN: WUFOO_SUBDOMAIN
      WUFOO_API_KEY: WUFOO_API_KEY

capability:

  consumes:
    - type: http
      namespace: "rest-v3-comments"
      baseUri: "https://{{env.WUFOO_SUBDOMAIN}}.wufoo.com/api/v3"
      description: "Wufoo REST API — Comments business capability. Self-contained, no shared references."
      authentication:
        type: basic
        username: "{{env.WUFOO_API_KEY}}"
        password: "footastic"
      resources:
        - name: "form-comments"
          path: "/forms/{identifier}/comments.{format}"
          operations:
            - name: "listFormComments"
              method: GET
              description: "List comments left on form entries."
              inputParameters:
                - { name: identifier, in: path, type: string, required: true, description: "Form hash or title." }
                - { name: format, in: path, type: string, required: true, description: "json or xml" }
                - { name: entryId, in: query, type: integer, required: false, description: "Filter to one entry." }
                - { name: pageStart, in: query, type: integer, required: false, description: "Offset, default 0." }
                - { name: pageSize, in: query, type: integer, required: false, description: "Page size, max 100." }
                - { name: pretty, in: query, type: boolean, required: false, description: "Pretty-print." }
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: "$." }]
        - name: "form-comments-count"
          path: "/forms/{identifier}/comments/count.{format}"
          operations:
            - name: "countFormComments"
              method: GET
              description: "Return form comment count."
              inputParameters:
                - { name: identifier, in: path, type: string, required: true, description: "Form hash or title." }
                - { name: format, in: path, type: string, required: true, description: "json or xml" }
                - { name: pretty, in: query, type: boolean, required: false, description: "Pretty-print." }
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: "$." }]

  exposes:
    - type: rest
      namespace: "rest-v3-comments-rest"
      port: 8080
      description: "REST adapter for Wufoo REST API — Comments."
      resources:
        - path: "/v1/forms/{identifier}/comments"
          name: "form-comments"
          description: "Comments on form entries."
          operations:
            - method: GET
              name: "listFormComments"
              description: "List form entry comments."
              call: "rest-v3-comments.listFormComments"
              with:
                identifier: "rest.identifier"
                format: "rest.format"
                entryId: "rest.entryId"
                pageStart: "rest.pageStart"
                pageSize: "rest.pageSize"
                pretty: "rest.pretty"
              outputParameters: [{ type: object, mapping: "$." }]
        - path: "/v1/forms/{identifier}/comments/count"
          name: "form-comments-count"
          description: "Form comment count."
          operations:
            - method: GET
              name: "countFormComments"
              description: "Return form comment count."
              call: "rest-v3-comments.countFormComments"
              with:
                identifier: "rest.identifier"
                format: "rest.format"
                pretty: "rest.pretty"
              outputParameters: [{ type: object, mapping: "$." }]

    - type: mcp
      namespace: "rest-v3-comments-mcp"
      port: 9090
      transport: http
      description: "MCP adapter for Wufoo REST API — Comments."
      tools:
        - name: "list-form-comments"
          description: "List form entry comments."
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: "rest-v3-comments.listFormComments"
          with:
            identifier: "tools.identifier"
            format: "tools.format"
            entryId: "tools.entryId"
            pageStart: "tools.pageStart"
            pageSize: "tools.pageSize"
            pretty: "tools.pretty"
          outputParameters: [{ type: object, mapping: "$." }]
        - name: "count-form-comments"
          description: "Return form comment count."
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: "rest-v3-comments.countFormComments"
          with:
            identifier: "tools.identifier"
            format: "tools.format"
            pretty: "tools.pretty"
          outputParameters: [{ type: object, mapping: "$." }]