PIpipeshub-ai
Conversations

Submit feedback on AI response

Changed on

Append a feedback entry to a bot-response message.

Overview

Feedback helps improve AI response quality over time. You can record an overall helpfulness signal, issue categories, and free-text comments. Each call appends a new entry to the message; previous entries are preserved.

Feedback options

  • isHelpful — overall thumbs up/down.
  • categories — issue or positive categories from a fixed list.
  • comments — free-text positive and negative.

Restrictions

Feedback can only be submitted on bot_response messages — user queries and system messages are rejected with 400.

Who can submit

The conversation's initiator, or any user it is shared with (at any access level) while isShared is true. Agent conversations are 404 here.

Body fields other than isHelpful, categories and comments are dropped by the validator, not refused. metrics is always computed by the server.

post/conversations/{conversationId}/message/{messageId}/feedback

Request

  • Base URL
    https://app.pipeshub.com/api/v1
  • URL
    https://app.pipeshub.com/api/v1/conversations/{conversationId}/message/{messageId}/feedback
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: /api/v1/oauth2/authorize
      Client credentials
      Token URL: /api/v1/oauth2/token scopes: conversation:write

Path parameters

conversationIdstring objectId required

Unique conversation identifier.

messageIdstring objectId required

Identifier of the bot-response message being rated.

Request body

isHelpfulboolean

Overall helpfulness signal (thumbs up/down).

categoriesstring[]

Issue or positive categories that apply to the response.

Response

Feedback submitted successfully.

conversationIdstring objectId required

Conversation the feedback was attached to.

messageIdstring objectId required

Message the feedback was attached to.

Changes

  • dbb5e203b445Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status