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

# List Inbox Items

`GET /user_session/inbox`

## Query parameters

- `page` integer
- `pageSize` integer
- `recipientId` string
- `kind` 'question' | 'annotation' | 'task' | 'maintenance'
- `state` 'open' | 'completed' | 'dismissed'
- `scope` 'mine' | 'team'
- `teamId` string

## Response `200`

OK

- PaginatedResponseBodyInboxItem
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` InboxItem[], required
    - `attributes` InboxItemAttributes, required
      - `analysisId` string
      - `context` string, required
      - `dueAt` string, date-time
      - `incidentId` string
      - `kind` 'question' | 'annotation' | 'task' | 'maintenance', required
      - `occurredAt` string, date-time, required
      - `proposedChange` string
      - `reason` string, required
      - `recipientId` string
      - `state` 'open' | 'completed' | 'dismissed', required
      - `targetId` string — Canonical target ID; absent for maintenance until a canonical resource exists.
      - `targetKind` 'discussion-thread' | 'normalized-event' | 'task' | 'maintenance-request', required
      - `teamId` string
      - `title` string, required
    - `id` string, required
  - `pagination` Pagination, required
    - `page` integer, required
    - `pageSize` integer, required
    - `total` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-09-14** (v1) `a016075e69a1` — 1 breaking, 2 info
  - the response property `data/items/attributes/targetId` became optional for the status `200`
  - added the required property `data/items/attributes/occurredAt` to the response with the `200` status
  - added the required property `data/items/attributes/title` to the response with the `200` status
- **2026-09-11** (v1) `ed03dea25301` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rezible/apis/rezible-api/changes/user_session/inbox/get.md)

---

[API](https://skmtc.dev/rezible/apis/rezible-api.md) · [All operations](https://skmtc.dev/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rezible/apis/rezible-api/revisions/b1e1da7c37c7?raw)