Skip to main content
POST
/
api
/
agents
/
chat
/
{conversationUid}
/
messages
/
{messageUid}
/
feedback
Submit message feedback
curl --request POST \
  --url https://api.example.com/api/agents/chat/{conversationUid}/messages/{messageUid}/feedback \
  --header 'Content-Type: application/json' \
  --data '
{
  "rating": {},
  "comment": {}
}
'
Submit feedback on a specific agent chat message. Users can rate a message (like/dislike), leave a comment, or both. Feedback is stored as an append-only log so all history is preserved. Partial updates are supported: sending only rating carries forward the existing comment (and vice versa). To clear a field, send it explicitly as null.

​
Path parameters

​
conversationUid
string
required
UUID of the conversation the message belongs to.
​
messageUid
string
required
UUID of the message to leave feedback on.

​
Request body

​
rating
string | null
One of like, dislike, or null. Omit the key entirely to keep the current rating unchanged.
​
comment
string | null
Free-text feedback comment. Omit the key entirely to keep the current comment unchanged. Send null to clear it.

​
Behavior matrix

ratingcommentBehavior
"like" / "dislike"omittedSave rating, carry forward existing comment
"like" / "dislike""text"Save both
"like" / "dislike"nullSave rating, clear comment
null"text"Clear rating, save comment
omitted"text"Keep existing rating, save comment
nullnullNo-op, returns 204
omittedomittedNo-op, returns 204

​
Example: rate a message

{
  "rating": "like"
}

​
Example: rate with a comment

{
  "rating": "dislike",
  "comment": "The invoice total was incorrect"
}

​
Example: add a comment without changing the rating

{
  "comment": "Could have included the payment link"
}

​
Response

Returns 200 with the saved feedback object: 
{
  "status": "success",
  "data": {
    "uid": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "message_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "rating": "like",
    "comment": null,
    "created_at": "2026-04-24T12:00:00+00:00"
  }
}
Returns 204 with no body when both rating and comment are null or omitted.

​
Errors

StatusCondition
400Invalid rating value (not like, dislike, or null)
404Conversation not found, or message does not belong to the conversation
403User not authorized for this conversation’s organization
Feedback is append-only. Every submission creates a new record rather than overwriting the previous one. The GET .../messages endpoint returns the latest feedback per message for the requesting user.