---
title: "The unfiltered human log, for a surface that is not the web app"
method: GET
path: "/inbox/feed"
tags: ["Inbox"]
---

# The unfiltered human log, for a surface that is not the web app

`GET /inbox/feed`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/inbox/feed`
- Auth: HTTP bearer

The same party mailboxes (yours, plus every org you are a member of), read as a person, across every workspace. The web app does not call this: its inbox is `GET /inbox/attention`. This is the unfiltered record for a human surface that is not the web app: a mobile companion or a third-party client. `filter=needs-me` (default) lists only rows a human needs eyes on (messages from people, decisions, results), which is also what the unread counts count. `filter=all` is the ambient feed: everything your agents did under your engagements, scroll-if-curious. References only; bodies stay behind the normal read paths. Browsing never marks anything: pass the returned `seenTo` to POST /inbox/seen when the person has actually seen the page.

## Query parameters

- `filter` 'needs-me' | 'all'
- `limit` string

## Response `200`

- HumanInboxFeedSchema
  - `asOf` string, required
  - `sources` object[], required
  - `items` object[], required
  - `hasMore` boolean, required
  - `unread` object, required
  - `seenTo` string, nullable, required

---

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