---
title: "Stream mailbox events (server-sent events)"
method: GET
path: "/api/emails/{address}/events"
tags: ["Email"]
---

# Stream mailbox events (server-sent events)

`GET /api/emails/{address}/events`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/events`
- Auth: HTTP bearer

Answers text/event-stream. Without a cursor the stream starts at the present; with `since` (a cursor from /api/email/changes or the `id` of any earlier event) it first replays every change after that point, then follows the mailbox journal live: each frame carries the change's type as the event name (message.received, message.updated, message.deleted, message.moved, message.status, mailbox.resync_required, assistant.item.delegated, assistant.item.recalled, ...), the change as JSON data with its resumable `cursor`, and that same cursor as the frame id. The first frame is `ready` with the cursor to resume from; a keep-alive comment arrives every 20 seconds; the connection closes after about 5 minutes with a `close` frame and a `retry:` hint. Reconnect with `Last-Event-ID` (or `since`) to resume with no gap and no duplicate. Agent tokens are confined to the mailboxes the agent operates. An entry about a work item made from authentication mail carries its `title` and `ask` redacted for a token without `email:auth_secrets`.

## Path parameters

- `address` string, required

## Query parameters

- `since` string

## Headers

- `Last-Event-ID` string

## Response `200`

An event stream that stays open for about 5 minutes

## Other responses

- `401`: Missing or invalid API key
- `404`: Mailbox not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)