Skip to main content
GET
Poll for new content
Each call returns only the new blocks since your last one and long-polls (waits up to the deadline) for more. Pass since = the cursor from your previous call (0 on the first call); has_more tells you whether the reply is still going. For browsers, GET /messages/{id}/stream (SSE) is the natural fit.

Authorizations

Authorization
string
header
required

Requires an API key. See the Authentication guide.

Path Parameters

message_id
string
required

Query Parameters

since
integer
default:0

Block-index cursor; 0 on first call.

Required range: x >= 0
wait_ms
integer
default:15000

Long-poll deadline in ms. Capped at 30000.

Required range: 0 <= x <= 30000

Response

200 - application/json

New blocks (possibly empty if the deadline hit).

message_id
string
required
cursor
integer
required
status
string
required
has_more
boolean
required
total_blocks
integer
required
returned_from
integer
required
blocks
Blocks · object[]