Get feedbacks grouped by conversation

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/feedbacks/grouped_by_conversation/"

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}/feedbacks/grouped_by_conversation/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "count": 123,
  "next": "<string>",
  "previous": "<string>",
  "results": [
    {
      "conversation_id": "123e4567-e89b-12d3-a456-426614174000",
      "conversation_title": "Product pricing discussion",
      "conversation_created_at": "2026-03-01T10:30:00Z",
      "agent_name": "Customer Support Assistant",
      "conversation_is_archived": false,
      "to_review_count": 3,
      "reviewed_count": 1,
      "feedbacks": [
        {
          "id": "abc-123",
          "status": "to_review",
          "feedback": "The answer was inaccurate",
          "is_positive": false
        },
        {
          "id": "abc-124",
          "status": "to_review",
          "feedback": "This needs more detail",
          "is_positive": false
        },
        {
          "id": "abc-125",
          "status": "to_review",
          "feedback": "Missing citation for this claim",
          "is_positive": false
        },
        {
          "id": "abc-126",
          "status": "reviewed",
          "feedback": "Great explanation!",
          "is_positive": true
        }
      ]
    }
  ]
}

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

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

Feedback

Get feedbacks grouped by conversation

Retrieve feedbacks grouped by their associated playground conversation with unified pagination and sorting.

Access Control:

Admins see all feedback in the project
Regular users see only feedback they submitted

Grouping Logic:

Feedbacks are grouped by their conversation field (FK to PlaygroundConversation)
Conversation groups and ungrouped feedbacks are returned in a single flat array
Ungrouped feedbacks appear as single-item groups with conversation_id: null
Each group includes status counts and all associated feedbacks

Pagination:

Paginates across the unified list of conversation groups and ungrouped feedbacks
Use limit and offset parameters to page through results
The count field reflects the total number of displayable groups (conversations + ungrouped)

Status Filtering:

status=to_review: Groups with ANY unreviewed feedback
status=reviewed: Groups where ALL feedbacks are reviewed
No status filter: All groups

Sorting:

All groups are sorted together by the most recent feedback update time
With status=to_review: Sorted by the most recent “to_review” feedback update
With status=reviewed: Sorted by the most recent “reviewed” feedback update
Without status filter: Sorted by the most recent feedback update (any status)
Feedbacks within each group are ordered by most recently updated first

Impersonation:

When using impersonation, returns feedback submitted by the impersonated user

GET

projects

{project_id}

feedbacks

grouped_by_conversation

Get feedbacks grouped by conversation

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/feedbacks/grouped_by_conversation/"

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}/feedbacks/grouped_by_conversation/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "count": 123,
  "next": "<string>",
  "previous": "<string>",
  "results": [
    {
      "conversation_id": "123e4567-e89b-12d3-a456-426614174000",
      "conversation_title": "Product pricing discussion",
      "conversation_created_at": "2026-03-01T10:30:00Z",
      "agent_name": "Customer Support Assistant",
      "conversation_is_archived": false,
      "to_review_count": 3,
      "reviewed_count": 1,
      "feedbacks": [
        {
          "id": "abc-123",
          "status": "to_review",
          "feedback": "The answer was inaccurate",
          "is_positive": false
        },
        {
          "id": "abc-124",
          "status": "to_review",
          "feedback": "This needs more detail",
          "is_positive": false
        },
        {
          "id": "abc-125",
          "status": "to_review",
          "feedback": "Missing citation for this claim",
          "is_positive": false
        },
        {
          "id": "abc-126",
          "status": "reviewed",
          "feedback": "Great explanation!",
          "is_positive": true
        }
      ]
    }
  ]
}

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

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "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

Query Parameters

status

enum<string>

Filter by conversation status (based on feedback statuses)

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

Available options:

to_review,

reviewed

string

Search in feedback text or user email (case-insensitive)

include_archived

enum<string>

Set to "true" to include feedbacks from archived conversations. Defaults to false.

Available options:

true,

false

limit

integer

default:100

Maximum number of results per page

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of results to skip for pagination

Required range: x >= 0

Response

Successful response

count

integer

Total number of results

string<uri> | null

URL to next page of results

string<uri> | null

URL to previous page of results

results

object[]

Flat array of conversation groups and ungrouped feedbacks, sorted by last updated feedback. Ungrouped feedbacks appear as single-item groups with conversation_id: null.

Show child attributes

Concepts

Endpoints

Get feedbacks grouped by conversation

Authorizations

Headers

Path Parameters

Query Parameters

Response