Attention
Follow one stream of stalled, waiting, failed, and finished work across the account.
| Operation | Request |
|---|---|
| Stream attention | GET /v1/attention |
Stream attention
GET /v1/attention · streamAttention
Private to the signed-in account. Server-sent events in seq order, derived from the account's run heartbeats and work runs: a working run with no output for 20 minutes (run_stalled), a run awaiting input or errored, a live run holding an issue with no progress for 20 minutes (claim_no_progress), a failed landing, and a finished work run. Each condition is raised once. The last 1000 events are kept; sources older than 24 hours raise none. The stream ends after about two hours; reconnect with the last seq. Comments keep the connection open. Events grant no execution or steering authority.
Sign-in: a bearer credential in the Authorization header.
appBearer: A live app sess_ session or oa_sk_ sign-in key. Account-bound oak_ keys are accepted only where the operation declares them and their scopes permit it. API cookies are ignored.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
after | query | integer | No | Send events with seq greater than this; 0 or absent for every event still kept. Without it, a Last-Event-ID header is used. |
Response
200 — An event stream of AttentionEvent.
Content type: text/event-stream
Type: AttentionEvent
| Field | Type | Required | Description |
|---|---|---|---|
seq | integer | Yes | Strictly increasing per account. |
at | integer (int64) | Yes | Unix milliseconds. |
agent | string or null | No | Agent definition ID, never an agent name. |
Errors
| Status | Meaning | Body |
|---|---|---|
| 400, 401, 403, 503 | Invalid event number, signed out, denied, or unavailable. | AppAccountError |
Example
curl 'https://api.openagents.com/v1/attention' \
-H "Authorization: Bearer $OPENAGENTS_TOKEN"