v10

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-0582185581.9 KB
Conversations

Submit feedback on AI response

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.

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

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.