Trustpilot Service Reviews API — Review Management

naftiko: 1.0.0-alpha2
info:
  label: Trustpilot Service Reviews API — Review Management
  description: 'Trustpilot Service Reviews API — Review Management. 8 operations. Lead operation: Get Private Review. Self-contained
    Naftiko capability covering one Trustpilot business surface.'
  tags:
  - Trustpilot
  - Review Management
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TRUSTPILOT_API_KEY: TRUSTPILOT_API_KEY
capability:
  consumes:
  - type: http
    namespace: service-reviews-review-management
    baseUri: https://api.trustpilot.com
    description: Trustpilot Service Reviews API — Review Management business capability. Self-contained, no shared references.
    resources:
    - name: v1-private-reviews-reviewId
      path: /v1/private/reviews/{reviewId}
      operations:
      - name: getprivatereview
        method: GET
        description: Get Private Review
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
    - name: v1-private-reviews-reviewId-find-reviewer
      path: /v1/private/reviews/{reviewId}/find-reviewer
      operations:
      - name: findreviewer
        method: POST
        description: Find Reviewer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-private-reviews-reviewId-reply
      path: /v1/private/reviews/{reviewId}/reply
      operations:
      - name: createreviewreply
        method: POST
        description: Create Review Reply
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletereviewreply
        method: DELETE
        description: Delete Review Reply
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
    - name: v1-private-reviews-reviewId-tags
      path: /v1/private/reviews/{reviewId}/tags
      operations:
      - name: getreviewtags
        method: GET
        description: Get Review Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
      - name: setreviewtags
        method: POST
        description: Set Review Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: addreviewtags
        method: PUT
        description: Add Review Tags
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletereviewtag
        method: DELETE
        description: Delete Review Tag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: reviewId
          in: path
          type: string
          required: true
        - name: group
          in: query
          type: string
          required: true
        - name: value
          in: query
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.TRUSTPILOT_API_KEY}}'
  exposes:
  - type: rest
    namespace: service-reviews-review-management-rest
    port: 8080
    description: REST adapter for Trustpilot Service Reviews API — Review Management. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/v1/private/reviews/{reviewid}
      name: v1-private-reviews-reviewid
      description: REST surface for v1-private-reviews-reviewId.
      operations:
      - method: GET
        name: getprivatereview
        description: Get Private Review
        call: service-reviews-review-management.getprivatereview
        with:
          reviewId: rest.reviewId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/private/reviews/{reviewid}/find-reviewer
      name: v1-private-reviews-reviewid-find-reviewer
      description: REST surface for v1-private-reviews-reviewId-find-reviewer.
      operations:
      - method: POST
        name: findreviewer
        description: Find Reviewer
        call: service-reviews-review-management.findreviewer
        with:
          reviewId: rest.reviewId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/private/reviews/{reviewid}/reply
      name: v1-private-reviews-reviewid-reply
      description: REST surface for v1-private-reviews-reviewId-reply.
      operations:
      - method: POST
        name: createreviewreply
        description: Create Review Reply
        call: service-reviews-review-management.createreviewreply
        with:
          reviewId: rest.reviewId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletereviewreply
        description: Delete Review Reply
        call: service-reviews-review-management.deletereviewreply
        with:
          reviewId: rest.reviewId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/private/reviews/{reviewid}/tags
      name: v1-private-reviews-reviewid-tags
      description: REST surface for v1-private-reviews-reviewId-tags.
      operations:
      - method: GET
        name: getreviewtags
        description: Get Review Tags
        call: service-reviews-review-management.getreviewtags
        with:
          reviewId: rest.reviewId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: setreviewtags
        description: Set Review Tags
        call: service-reviews-review-management.setreviewtags
        with:
          reviewId: rest.reviewId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: addreviewtags
        description: Add Review Tags
        call: service-reviews-review-management.addreviewtags
        with:
          reviewId: rest.reviewId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletereviewtag
        description: Delete Review Tag
        call: service-reviews-review-management.deletereviewtag
        with:
          reviewId: rest.reviewId
          group: rest.group
          value: rest.value
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: service-reviews-review-management-mcp
    port: 9090
    transport: http
    description: MCP adapter for Trustpilot Service Reviews API — Review Management. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: get-private-review
      description: Get Private Review
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: service-reviews-review-management.getprivatereview
      with:
        reviewId: tools.reviewId
      outputParameters:
      - type: object
        mapping: $.
    - name: find-reviewer
      description: Find Reviewer
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: service-reviews-review-management.findreviewer
      with:
        reviewId: tools.reviewId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-review-reply
      description: Create Review Reply
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: service-reviews-review-management.createreviewreply
      with:
        reviewId: tools.reviewId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-review-reply
      description: Delete Review Reply
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: service-reviews-review-management.deletereviewreply
      with:
        reviewId: tools.reviewId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-review-tags
      description: Get Review Tags
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: service-reviews-review-management.getreviewtags
      with:
        reviewId: tools.reviewId
      outputParameters:
      - type: object
        mapping: $.
    - name: set-review-tags
      description: Set Review Tags
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: service-reviews-review-management.setreviewtags
      with:
        reviewId: tools.reviewId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: add-review-tags
      description: Add Review Tags
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: service-reviews-review-management.addreviewtags
      with:
        reviewId: tools.reviewId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-review-tag
      description: Delete Review Tag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: service-reviews-review-management.deletereviewtag
      with:
        reviewId: tools.reviewId
        group: tools.group
        value: tools.value
      outputParameters:
      - type: object
        mapping: $.