Rate an answer in a conversation

PUT

conversations

{conversation_id}

messages

{message_id}

feedback

curl --request PUT "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60/messages/7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36/feedback" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"rating": "down", "note": "This describes the old dashboard."}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
message_id = "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36"
response = requests.put(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}/messages/{message_id}/feedback",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"rating": "down", "note": "This describes the old dashboard."},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const messageId = '7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}/messages/${messageId}/feedback`,
  {
    method: 'PUT',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ rating: 'down', note: 'This describes the old dashboard.' }),
  },
)
console.log(await response.json())

{
  "id": "b7c2e9a4-5d18-4f63-9a0e-2c4d6f8b1e37",
  "message_id": "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36",
  "conversation_id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "rating": "down",
  "note": "This describes the old dashboard.",
  "actor": { "type": "service", "id": "2f6b8d1c-4a35-4e79-b0c2-8d7e5f3a1b94" },
  "created_at": "2026-10-12T10:02:41.118204+00:00",
  "updated_at": "2026-10-12T10:02:41.118204+00:00"
}

{ "code": "validation_error", "message": "'rating' must be 'up' or 'down'." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Sets your rating of one answer, or replaces the rating you already gave it. You can rate only in a conversation you started, and only an answer: rating a question returns 400. Each caller has at most one rating per answer, so sending this again changes the rating and keeps its id and created_at. A rating of down puts the question that was answered into List unanswered questions with the reason rated_unhelpful, where an Owner or Administrator reads it with the note. See Analytics. A conversation that does not exist, belongs to another organization or was started by someone else returns 404, and so does a message that is not in it or a malformed ID. That includes an owner or admin, who can read the ratings on a colleague’s conversation but cannot add one. A credential that cannot send messages gets 403.

string

required

The conversation ID.

string

required

The answer’s id, from Send a message or List messages.

string

required

up or down. Any other value returns 400.

string

An optional note, stored as plain text, of up to 1,000 characters. Leading and trailing space is removed, and a blank note is stored as none. Control characters are refused.

Response

The stored rating.

string

required

The rating’s ID.

string

required

The answer that was rated.

string

required

The conversation the answer belongs to.

string

required

up or down.

string | null

required

The note sent with the rating, or null.

object

required

Who gave the rating: type is user for a console session or service for an API key, and id identifies that user or key.

string

required

When the rating was first given, ISO 8601 in UTC.

string

required

When the rating was last set, ISO 8601 in UTC.

curl --request PUT "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60/messages/7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36/feedback" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"rating": "down", "note": "This describes the old dashboard."}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
message_id = "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36"
response = requests.put(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}/messages/{message_id}/feedback",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"rating": "down", "note": "This describes the old dashboard."},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const messageId = '7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}/messages/${messageId}/feedback`,
  {
    method: 'PUT',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ rating: 'down', note: 'This describes the old dashboard.' }),
  },
)
console.log(await response.json())

{
  "id": "b7c2e9a4-5d18-4f63-9a0e-2c4d6f8b1e37",
  "message_id": "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36",
  "conversation_id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "rating": "down",
  "note": "This describes the old dashboard.",
  "actor": { "type": "service", "id": "2f6b8d1c-4a35-4e79-b0c2-8d7e5f3a1b94" },
  "created_at": "2026-10-12T10:02:41.118204+00:00",
  "updated_at": "2026-10-12T10:02:41.118204+00:00"
}

{ "code": "validation_error", "message": "'rating' must be 'up' or 'down'." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Last modified on October 13, 2026

curl --request PUT "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60/messages/7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36/feedback" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"rating": "down", "note": "This describes the old dashboard."}'

import os, requests

conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
message_id = "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36"
response = requests.put(
    f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}/messages/{message_id}/feedback",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    json={"rating": "down", "note": "This describes the old dashboard."},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
const messageId = '7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}/messages/${messageId}/feedback`,
  {
    method: 'PUT',
    headers: {
      Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ rating: 'down', note: 'This describes the old dashboard.' }),
  },
)
console.log(await response.json())

{
  "id": "b7c2e9a4-5d18-4f63-9a0e-2c4d6f8b1e37",
  "message_id": "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36",
  "conversation_id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
  "rating": "down",
  "note": "This describes the old dashboard.",
  "actor": { "type": "service", "id": "2f6b8d1c-4a35-4e79-b0c2-8d7e5f3a1b94" },
  "created_at": "2026-10-12T10:02:41.118204+00:00",
  "updated_at": "2026-10-12T10:02:41.118204+00:00"
}

{ "code": "validation_error", "message": "'rating' must be 'up' or 'down'." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

Rate an answer in a conversation

Response

​Response

Response