---
title: "Admin Inbox List"
method: GET
path: "/v1/admin/inbox"
---

# Admin Inbox List

`GET /v1/admin/inbox`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/admin/inbox`
- Auth: none declared

Browse inbound messages captured by the Path A merged email-intake
pipeline. Filter by classification (`reply` / `bounce` /
`auto-response` / `abuse-report` / `unknown`), reply_intent
(`take_it_down` / `yes_keep_going` / `payout_question` /
`tell_me_more` / `who_are_you`), status
(`awaiting` / `replied` / `auto_handled` / `stale` / `new`) and
free-text search over from/subject/body.

``awaiting_action=true`` is a compatibility shortcut equivalent to
``status=awaiting`` — keeps the spec'd URL
(``/admin/inbox?awaiting_action=true``) working as the stale-reply
TG alert link target.

``reply_intent`` (2026-08-08) matches the column the inbound-reply
bridge and its backlog sweep stamp. Exact match on the enum value,
same shape as ``classification`` — no normalization, so the filter
means exactly what ``by_reply_intent`` on
``GET /v1/admin/inbox/stats`` counts. It exists because there was no
server-side way to ask "which rows are take_it_down?": the
2026-08-07 backfill stamped 26 of them and finding those 26 meant
paginating 800 rows client-side. Rows the bridge leaves NULL
(UNRELATED / machine-notice) are outside every value of this filter
by design.

## Query parameters

- `classification` string, nullable
- `reply_intent` string, nullable
- `q` string, nullable
- `status` string, nullable
- `awaiting_action` boolean, nullable
- `limit` integer
- `offset` integer

## Headers

- `x-storyflo-email-token` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)