---
title: "List Inbox Items"
method: GET
path: "/inbox"
tags: ["Inbox"]
---

# List Inbox Items

`GET /inbox`

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).

## Query parameters

- `status` 'unreviewed' | 'reviewed' | 'dismissed' — Filter by review status. Defaults to "unreviewed".
- `triggerType` 'guardrail' | 'expectation_check' | 'novelty' | 'manual_review' | 'revenue_risk' — Filter by trigger type.
- `axis` 'attention' | 'opportunity' — Filter by axis: "attention" for risk/quality triggers, "opportunity" for positive business signals.
- `minSeverity` integer — Minimum severity level to include (1-5).

## Response `200`

Inbox items retrieved successfully

- InboxItemSummary[] — Array of inbox items. Pagination via Link header.
  - `conversationId` string, uuid, required — The conversation ID.
  - `topic` string, nullable, required — Main topic of the conversation.
  - `triggerType` string, nullable, required — Primary trigger type that flagged this conversation.
  - `reviewStatus` 'unreviewed' | 'reviewed' | 'dismissed', required — Current review status.
  - `timestamp` string, date-time, required — When the inbox item was created (ISO 8601).
  - `messageCount` integer, 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).
  - `clusterSize` integer — When this card represents a root-cause cluster, total number of conversations sharing the cause.
  - `clusterMemberIds` string[] — IDs of the other conversations in the cluster.
  - `clusterRootCause` string, nullable — Root-cause label that anchors the cluster.

## Other responses

- `400` — Bad request - invalid parameters
- `500` — Server error

## Changes

- **2026-05-01** `c566e560677d` — 5 info
  - added the new optional `query` request parameter `axis`
  - added the optional property `items/axis` to the response with the `200` status
  - added the optional property `items/clusterMemberIds` to the response with the `200` status
  - added the optional property `items/clusterRootCause` to the response with the `200` status
  - …1 more
- **2026-05-01** `f52e699d4abf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/inbox/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)