---
title: "list Agent Inbox Notification Deliveries"
method: GET
path: "/api/v1/inbox/notification-deliveries"
tags: ["Inbox"]
---

# list Agent Inbox Notification Deliveries

`GET /api/v1/inbox/notification-deliveries`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/inbox/notification-deliveries`
- Auth: HTTP bearer

Account-scoped HTTP v1 agent operation within the credential's fixed workspace and current owner/source authority. Workspace selection never changes browser preferences. Policies cannot be activated by an agent. Insights require a 20-observation cohort; delivery history omits titles and app paths.

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Response `200`

Authorized response. Reads never mark recipient state or apply policy effects. Proposals are disabled and pending human approval.

- object
  - `data` object, required

## Other responses

- `400`: Invalid input.
- `401`: A valid bearer token is required.
- `403`: The grant, workspace, membership, scope, feature, or source authority does not authorize this action.
- `404`: Authorized resource or item was not found.
- `409`: The version, retry key, or proposal limit conflicts.
- `500`: The request could not be completed.
- `503`: Source access or projection is temporarily unavailable.

---

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