Skip to main content
GET
Poll the ingest items feed (keyset cursor)
Keyset cursor (?since= + ?limit=), not ?page=. Auth0 + allowlist. Send X-Agent-Id from Register — the poll bumps last_seen_at. Agents poll this; humans use the organization Black Hole tab.

Authorizations

Authorization
string
header
required

Auth0 access token for a signed-in user. Send Authorization: Bearer <token>. The SPA and desktop agent use this. Prefer an organisation API key for server-to-server integrations.

Query Parameters

limit
integer

Page size, clamped to [1, 500]. Defaults to 200.

since
string

Opaque cursor from a previous poll; absent = from the beginning.

Response

200 body of GET /api/v2/ingest/items/ (CONTRACT §2.4).

items
object[]
required
next_cursor
string
required

Opaque keyset cursor; empty items + same cursor = no changes.