Skip to main content
GET
/
inbox
cURL
curl --request GET \
  --url https://www.greenflash.ai/api/v1/inbox \
  --header 'Authorization: Bearer <token>'
[
  {
    "conversationId": "123e4567-e89b-12d3-a456-426614174000",
    "topic": "Billing dispute — charged twice for subscription",
    "triggerType": "revenue_risk",
    "reviewStatus": "unreviewed",
    "timestamp": "2025-10-15T09:32:00Z",
    "messageCount": 8
  },
  {
    "conversationId": "223e4567-e89b-12d3-a456-426614174001",
    "topic": "Bot gave incorrect refund policy",
    "triggerType": "guardrail",
    "reviewStatus": "unreviewed",
    "timestamp": "2025-10-15T08:17:00Z",
    "messageCount": 5
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
status
enum<string>
default:unreviewed

Filter by review status. Defaults to "unreviewed".

Available options:
unreviewed,
reviewed,
dismissed
​
triggerType
enum<string>

Filter by trigger type.

Available options:
guardrail,
expectation_check,
novelty,
manual_review,
revenue_risk
​
axis
enum<string>

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

Available options:
attention,
opportunity
​
minSeverity
integer

Minimum severity level to include (1-5).

Required range: 1 <= x <= 5

Response

Inbox items retrieved successfully

​
conversationId
string<uuid>
required

The conversation ID.

​
topic
string | null
required

Main topic of the conversation.

​
triggerType
string | null
required

Primary trigger type that flagged this conversation.

​
reviewStatus
enum<string>
required

Current review status.

Available options:
unreviewed,
reviewed,
dismissed
​
timestamp
string<date-time>
required

When the inbox item was created (ISO 8601).

​
messageCount
integer
required

Number of chat messages in the conversation.

​
axis
enum<string>

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

Available options:
attention,
opportunity,
manual
​
clusterSize
integer

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

​
clusterMemberIds
string<uuid>[]

IDs of the other conversations in the cluster.

​
clusterRootCause
string | null

Root-cause label that anchors the cluster.