Sign in

v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-013593344.3 KB
Inbox

List Inbox Items

List conversations that have been flagged for review. Filter by review status, trigger type, or severity to focus on what matters most. Results are ordered by attention score (unreviewed) or last updated (reviewed/dismissed).

get/inbox

Query parameters

status'unreviewed' | 'reviewed' | 'dismissed'

Filter by review status. Defaults to "unreviewed".

Filter by review status. Defaults to "unreviewed".

triggerType'guardrail' | 'expectation_check' | 'novelty' | 'manual_review' | 'revenue_risk'

Filter by trigger type.

Filter by trigger type.

axis'attention' | 'opportunity'

Filter by axis: "attention" for risk/quality triggers, "opportunity" for positive business signals.

Filter by axis: "attention" for risk/quality triggers, "opportunity" for positive business signals.

minSeverityinteger

Minimum severity level to include (1-5).

Minimum severity level to include (1-5).

Response

Inbox items retrieved successfully

conversationIdstring uuid required

The conversation ID.

topicstring nullable required

Main topic of the conversation.

triggerTypestring nullable required

Primary trigger type that flagged this conversation.

reviewStatus'unreviewed' | 'reviewed' | 'dismissed' required

Current review status.

timestampstring date-time required

When the inbox item was created (ISO 8601).

messageCountinteger required

Number of chat messages in the conversation.

axis'attention' | 'opportunity' | 'manual'

Top-level axis for this item: attention (risk), opportunity (positive signal), or manual (team flagged).

clusterSizeinteger

When this card represents a root-cause cluster, total number of conversations sharing the cause.

clusterMemberIdsstring[]

IDs of the other conversations in the cluster.

clusterRootCausestring nullable

Root-cause label that anchors the cluster.