OMomniapp
AI

List AI feedback

Changed on

List the thumbs up and thumbs down users gave AI responses in this organization, with any comment and reason, from the Omni app, Slack, and POST /api/v1/ai/jobs/{jobId}/feedback. Each rating or comment is its own event, newest first. A user can rate the same job more than once, so their latest event for a job is their current verdict. Filters by when the feedback was given (the last 30 days by default, at most 90 days per request), by rating, and by shared model. Paginated via opaque pageInfo.nextCursor: pass it back as cursor, with pageSize only, to fetch the next page. A page can hold fewer records than pageSize while hasNextPage is true, so keep paging until nextCursor is null. A record can repeat across pages when new feedback loads during a walk, so deduplicate by id. Feedback is read from Omni's analytics warehouse, so new feedback appears after a delay. Organization admins only.

get/api/v1/ai/feedback

Request

Query parameters

cursorstring

Cursor for pagination (from previous response nextCursor)

Example:eyJpZCI6IjEyMzQ1In0
pageSizeinteger

Number of results per page (1-100, integer)

Example:20
endDatestring date-time

Exclusive upper bound on when the feedback was given, as an ISO 8601 date-time. Defaults to now.

Example:2025-02-01T00:00:00Z
modelIdstring uuid

Only feedback on responses from this shared model. Feedback given through Slack or the API does not record a model, so this filter leaves it out.

Example:123e4567-e89b-12d3-a456-426614174000
rating'good' | 'bad'

Only feedback with this rating.

Example:bad
startDatestring date-time

Inclusive lower bound on when the feedback was given, as an ISO 8601 date-time. Defaults to 30 days before endDate. The window may span at most 90 days.

Example:2025-01-01T00:00:00Z

Response

A page of feedback events.

Example response

{
  "records": [
    {
      "category": "wrong_fields_or_filters",
      "comment": "Grouped by order date instead of ship date.",
      "conversationId": "660e8400-e29b-41d4-a716-446655440001",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "id": "9b2f7c1e-3d4a-4e5f-8a6b-7c8d9e0f1a2b",
      "jobId": "550e8400-e29b-41d4-a716-446655440000",
      "modelId": "123e4567-e89b-12d3-a456-426614174000",
      "prompt": "What were our top products last week?",
      "rating": "bad",
      "source": "web",
      "userId": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
    }
  ]
}

Changes