Skip to main content
GET
Pull events

Authorizations

Authorization
string
header
required

Agent Token (rly_live_…), shown once when the agent is created.

Query Parameters

after
integer
default:0

The highest sequence this consumer has processed. 0 starts from the beginning of the retained log. cursor is accepted as an alias.

Required range: x >= 0
timeout
integer
default:0

Seconds to hold the request open when no events are pending. 0 returns immediately with any pending events (nonblocking pull).

Required range: 0 <= x <= 30
limit
integer
default:100
Required range: 1 <= x <= 100

Response

Events past the cursor, oldest first.

events
object[]
required
Maximum array length: 100
next_cursor
integer
required

The sequence of the last event on this page. Pass it as after on the next pull; it equals the request's after when the page is empty.

latest
integer
required

The highest sequence Relay has written to this agent's log.

has_more
boolean
required

True when next_cursor is behind latest, so another page is waiting.