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

Python

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)

200

{
  "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
        }
      ],
      "status_summary": "mixed",
      "feedback_count": 4,
      "latest_updated_at": "2026-02-26T10:30:00Z",
      "has_unreviewed": true
    }
  ]
}

Authorizations

BearerAuthTokenAuth

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

search · 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

200

application/json

Successful response

count · integer

Total number of results

next · string<uri> | null

URL to next page of results

previous · 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