List box events
Return Box work, lifecycle, and progress events so product UIs can show what the box is doing. Event payloads are extensible. Clients can long-poll this endpoint with sort=asc and a cursor to stream responses. Response events expose agent text, streaming partials via data.is_streaming, and tool calls/results via data.tools.
Authorizations
Box bearer token in the form box_.... Service API keys authenticate Box operations.
Path Parameters
Public Box id returned by create/list/get box calls.
^bx_[23456789abcdefghjkmnpqrstuvwxyz]{8}$Query Parameters
Maximum items to return.
1 <= x <= 200Opaque pagination cursor returned as pageInfo.nextCursor.
Sort direction for cursor pagination.
asc, desc Comma-separated event type filter, for example prompt,response,git_checkpoint.
Response
The agent's work on the box (prompts, responses, checkpoints), not box lifecycle. A box that was never prompted returns an empty list even though it started, stopped and resumed.
true
Stable success envelope discriminator added by v1.
"events.list"Box work and lifecycle event objects. Event shapes are intentionally extensible; branch on each event type when present.