v4

OpenAPI 3.1.02026-08-0255174167.5 KB
events

Open an event stream

Mints a short-lived, account-scoped subscription token for the live event stream. The SDKs call this for you behind new_events_connection(); the CLI uses it for the listen daemon. Re-mint before ttlSeconds elapses to keep the stream open.

Delivery is presence-based, not at-least-once: events that occur while you are disconnected are replayed only if you reconnect within 2 minutes. For guaranteed at-least-once delivery, webhooks and destinations are coming soon.

post/api/v1/listen/subscribe

Headers

Authorizationstring required

Your Dial API key, sent as Authorization: Bearer sk_live_...

Response

Subscription credentials.

subscribeKeystring
channelstring
tokenstring
ttlSecondsinteger