---
title: "get Agent Inbox Item"
method: GET
path: "/api/v1/inbox/items/{workspaceId}/{entryId}"
tags: ["Inbox"]
---

# get Agent Inbox Item

`GET /api/v1/inbox/items/{workspaceId}/{entryId}`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/inbox/items/{workspaceId}/{entryId}`
- 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.

## Path parameters

- `workspaceId` string, required
- `entryId` string, required

## 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
    - `entry` AgentInboxEntry
      - `notification` WorkspaceNotificationContext
        - `version` unknown, required
        - `intent` 'action' | 'information', required
        - `kind` 'review_requested' | 'revision_ready' | 'comment' | 'reply' | 'mention' | 'thread_reopened' | 'thread_resolved' | 'review_status' | 'submission_failed' | 'submission_completed' | 'sync_failed' | 'sync_recovered' | 'refresh_failed' | 'form_responses' | 'form_blocked' | 'form_recovered' | 'evaluation_ready' | 'research_results' | 'evidence_failed' | 'evidence_recovered' | 'assignment' | 'reassigned' | 'approval_blocked' | 'policy_approval' | 'webhook_failed' | 'job_failed' | 'responsibility_changed' | 'request_completed', required
        - `title` string, required
        - `summary` string, required
        - `recipientReason` string, required
        - `nextStep` string, nullable, required
        - `actionLabel` string, required
        - `href` string, required
        - `actorName` string, required
        - `excerpt` string, nullable, required
        - `location` string, nullable, required
        - `resultCount` integer, nullable, 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)