Open an event stream

POST

https://api.getdial.ai/api/v1/listen/subscribe

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.

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.

$	curl -X POST https://api.getdial.ai/api/v1/listen/subscribe \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"subscribeKey": "subkey_live_9f8e7d6c5b4a3e2f1d0c",
3	"channel": "account-abc123",
4	"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50SWQiOiJhYmMxMjMiLCJleHAiOjE2ODk0MjQ4MDB9.4f7d8e9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e",
5	"ttlSeconds": 3600
6	}

Authentication

Response

Errors