---
title: "List inbox-item state rows for a user"
method: GET
path: "/api/inbox-state"
tags: ["Inbox State"]
---

# List inbox-item state rows for a user

`GET /api/inbox-state`

## Query parameters

- `userId` string, required
- `status` 'open' | 'snoozed' | 'dismissed' | 'done'
- `itemType` 'approval' | 'credential_missing' | 'broken_task' | 'to_read' | 'to_start_template'

## Response `200`

Inbox state rows

- object
  - `items` InboxItemState[], required
    - `id` string, required
    - `userId` string, required
    - `itemType` 'approval' | 'credential_missing' | 'broken_task' | 'to_read' | 'to_start_template', required
    - `itemId` string, required
    - `status` 'open' | 'snoozed' | 'dismissed' | 'done', required
    - `snoozeUntil` string
    - `dismissedAt` string
    - `doneAt` string
    - `createdAt` string, required
    - `lastUpdatedAt` string, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/ef761849166b/schema)