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));curl --request GET \
--url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/ \
--header 'Authorization: Bearer <token>'[
{
"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": {},
"reviewed_at": "2023-11-07T05:31:56Z",
"reviewed_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "[email protected]"
},
"query_id": 123,
"source": "<string>"
}
]{
"error": "Authentication credentials were not provided."
}{
"error": "User not found"
}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
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));curl --request GET \
--url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/playground-conversations/{conversation_id}/retrieve-feedback/ \
--header 'Authorization: Bearer <token>'[
{
"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": {},
"reviewed_at": "2023-11-07T05:31:56Z",
"reviewed_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "[email protected]"
},
"query_id": 123,
"source": "<string>"
}
]{
"error": "Authentication credentials were not provided."
}{
"error": "User not found"
}Authorizations
Use Authorization: Bearer <token>. The token is either a user token / OAuth access
token, or a service-account API key (cfk_...). A key is valid on every endpoint and
acts as its service account, an organization member with per-store permissions.
Refused keys answer 403 with Invalid API key., API key revoked.,
API key expired. or API key disabled..
Headers
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
UUID of the project
UUID of the conversation
Response
Feedback list for the conversation
User who submitted the feedback
Show child attributes
Show child attributes
to_review: Feedback pending review (default). Setting this on a closed feedback reopens it and clearsreviewed_at/reviewed_by.reviewed: Feedback has been revieweddismissed: Closed without action (won't fix, or archived praise)
to_review, reviewed, dismissed Feedback text comment
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
Show child attributes
true: Positive feedbackfalse: Negative feedbacknull: Neutral
The user message that was responded to (computed field)
Title of the conversation (computed field)
Auto-generated suggested action type
Auto-generated suggested action data
When the feedback was closed. Cleared on reopen. Null for feedback closed before this field existed.
User who closed it (null when closed by an unattended agent)
Show child attributes
Show child attributes
The chat message this feedback is about (computed from context)
Surface that raised it (computed from context): PlaygroundConversation,
MCP, Manual, ObjectsExplorer, cross_store_conversation, or api.