Get Inbox Item

Get the full detail of a single inbox item including conversation messages, analysis scores, trigger metadata, keywords, and participant information.

GET /inbox/{conversationId}

cURL

cURL

curl --request GET \
  --url https://www.greenflash.ai/api/v1/inbox/{conversationId} \
  --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,
  "summary": "Customer reports being charged twice for their monthly subscription. The assistant offered a refund but referenced an incorrect policy. The customer became frustrated when the refund timeline was unclear.",
  "triggers": [
    {
      "triggerType": "revenue_risk",
      "reason": "Customer threatening cancellation due to billing issue",
      "severity": 4,
      "source": "sentiment_analysis",
      "confidence": 0.92
    },
    {
      "triggerType": "guardrail",
      "reason": "Assistant cited incorrect refund policy",
      "severity": 3,
      "source": "factual_check",
      "confidence": 0.87
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "I was charged twice for my subscription this month. What's going on?",
      "timestamp": "2025-10-15T09:30:00Z"
    },
    {
      "role": "assistant",
      "content": "I'm sorry to hear that! Let me look into your account. I can see the duplicate charge and will initiate a refund right away.",
      "timestamp": "2025-10-15T09:30:15Z"
    }
  ],
  "analysis": {
    "sentiment": {
      "label": "negative",
      "score": -0.6
    },
    "frustration": {
      "label": "high",
      "score": 0.78
    },
    "struggle": {
      "label": "moderate",
      "score": 0.45
    },
    "qualityIndex": 4.2
  },
  "keywords": [
    "billing",
    "duplicate charge",
    "refund",
    "subscription",
    "cancellation"
  ],
  "participant": {
    "id": "789e4567-e89b-12d3-a456-426614174002",
    "externalId": "user-456",
    "name": "Alice Example",
    "email": "[e-mail]"
  }
}

Authorizations

Authorization · string · header · required

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

Path Parameters

conversationId · string<uuid> · required

The conversation ID to retrieve

Response

200

application/json

Inbox item 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.

summary · string | null · required

AI-generated summary of the conversation.

triggers · object[] · required

All triggers associated with this conversation.

Show child attributes

messages · object[] · required

Conversation messages.

Show child attributes

analysis · object · required

Analysis scores for this conversation.

Show child attributes

keywords · string[] | null · required

Keywords extracted from the conversation.

participant · object · required

Participant information.

Show child attributes