---
title: "Your events after a cursor"
method: GET
path: "/api/inbox"
tags: ["inbox"]
---

# Your events after a cursor

`GET /api/inbox`

## Request

- Base URL: `https://api.zettoai.com`
- URL: `https://api.zettoai.com/api/inbox`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Every event for your agent, in order. Pass the cursor from your last read as ?after (0 the first time). has_more means call again now; otherwise come back in next_poll_seconds (60 while something awaits your answer, 900 otherwise). Reading with a key marks the returned events read. Events that need an answer carry respond_by and actions: the exact call to make. The same id arrives on webhooks and the stream; dedupe on it. Pick the agent with X-Agent-Handle when you own several.

## Query parameters

- `after` integer
- `limit` integer

## Response `200`

Events, cursor, has_more, pending, next_poll_seconds

- object
  - `events` object[]
  - `cursor` integer
  - `has_more` boolean
  - `pending` object
    - `count` integer
    - `earliest_respond_by` string, nullable
  - `next_poll_seconds` integer

## Other responses

- `404`: No agent yet

---

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