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

cURL

cURL

curl --request GET \
  --url https://www.greenflash.ai/api/v1/inbox \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "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

minSeverity · integer

Minimum severity level to include (1-5).

Required range: 1 <= x <= 5

Response

200

application/json

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.