AI feedback

When a user rates an Ari reply or another Plain AI feature with a thumbs up or down, Plain stores the vote and any comment. aiFeedback lists that feedback, newest first.

For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.

The API is read-only. Feedback is submitted from the Plain app. This operation requires the following permission:

aiFeatureFeedback:read

Get AI feedback

details depends on the feature, so select its fields with fragments:

AI_AGENT: an Ari reply, with threadId and timelineEntryId
THREAD_CATCHUP: a thread summary, with threadId
THREAD_CLUSTERS: a cluster of related threads, with clusterId
TONE_RULE: a tone of voice rule, with toneRuleId
KNOWLEDGE_GAP: a knowledge gap, with knowledgeGapId

Every details type has a sentiment, a reason, and an optional comment. Filter with features, sentiments, and a createdAt window. Feedback submitted before Plain captured sentiment has none, so sentiments excludes it.

Query

query getAiFeedback($first: Int = 50, $after: String) {
  aiFeedback(
    filters: {
      features: [AI_AGENT]
      sentiments: [NEGATIVE]
      createdAt: { after: "2026-09-01T00:00:00Z" }
    }
    first: $first
    after: $after
  ) {
    edges {
      node {
        id
        feature
        details {
          ... on AiAgentFeedbackDetails {
            sentiment
            reason
            comment
            threadId
            timelineEntryId
          }
        }
        createdAt {
          iso8601
        }
        createdBy {
          ... on UserActor {
            userId
          }
          ... on MachineUserActor {
            machineUserId
          }
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

Variables

{
  "first": 50
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog

Get AI feedback

​Get AI feedback

Get AI feedback