Retrieve conversation feedback

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "given_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "[email protected]"
    },
    "status": "to_review",
    "feedback": "<string>",
    "context": {
      "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "query_id": 123,
      "source": "<string>",
      "user_query": "<string>",
      "additional_details": "<string>"
    },
    "is_positive": true,
    "user_message": "<string>",
    "conversation_title": "<string>",
    "suggested_action_type": "<string>",
    "suggested_action_data": {}
  }
]

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "User not found"
}

Conversations

Retrieve conversation feedback

List all feedback (including text content) attached to a conversation.

This is the only endpoint that returns other users’ feedback content on shared conversations — the project-level /feedbacks/ list stays scoped to the caller’s own feedback for non-admins.

Access Control:

Admins can read feedback of any conversation
Other members can read feedback of their own conversations or of shared conversations
Supports impersonation: visibility is evaluated for the impersonated user

GET

projects

{project_id}

playground-conversations

{conversation_id}

retrieve-feedback

Retrieve conversation feedback

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "given_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "[email protected]"
    },
    "status": "to_review",
    "feedback": "<string>",
    "context": {
      "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "query_id": 123,
      "source": "<string>",
      "user_query": "<string>",
      "additional_details": "<string>"
    },
    "is_positive": true,
    "user_message": "<string>",
    "conversation_title": "<string>",
    "suggested_action_type": "<string>",
    "suggested_action_data": {}
  }
]

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "User not found"
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer

Headers

X-Impersonate-Email

string<email>

Email of the user to impersonate. Requires CAN_IMPERSONATE_OTHER_USERS permission. If the target user is not found or does not have access to the project, the request proceeds as the authenticated user. Contact Clarifeye to enable this permission.

Path Parameters

project_id

string<uuid>

required

UUID of the project

conversation_id

string<uuid>

required

UUID of the conversation

Response

Feedback list for the conversation

string<uuid>

created_at

string<date-time>

updated_at

string<date-time>

given_by

object

User who submitted the feedback

Show child attributes

status

enum<string>

to_review: Feedback pending review (default)
reviewed: Feedback has been reviewed

Available options:

to_review,

reviewed

feedback

string

Feedback text comment

context

object

Free-form context, echoed back as submitted at creation. Conversation feedback carries conversation_id/query_id/source; MCP interaction feedback carries user_query; direct feedback may carry additional_details.

Show child attributes

is_positive

boolean | null

true: Positive feedback
false: Negative feedback
null: Neutral

user_message

string

The user message that was responded to (computed field)

conversation_title

string

Title of the conversation (computed field)

suggested_action_type

string | null

Auto-generated suggested action type

suggested_action_data

object

Auto-generated suggested action data

Concepts

Endpoints

Retrieve conversation feedback

Authorizations

Headers

Path Parameters

Response