Connect to an event stream

GET/event-streams/{event_stream_id}/events

Opens the Server-Sent Events connection for an event stream. Send Accept: text/event-stream and authenticate with the Authorization header; credentials in the query string are not accepted.

Each message carries the event's public ID in id, its type in event, and in data the same JSON returned when retrieving the event. Without a Last-Event-ID header, delivery resumes from the stream's stored cursor; with it, delivery resumes after that event. Keep-alive comments are sent periodically.

Only one connection per stream is allowed at a time. The server closes the connection after a maximum duration, or when the stream expires, is revoked, or the credential is revoked; reconnect with Last-Event-ID to continue. Each connection extends the stream's expiration.

Delivery has a latency of a few seconds and is not real-time.

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

event_stream_id*string

Header Parameters

Last-Event-ID?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/event-streams/string/events"
Empty