Skip to content
Linq

Events

Your brand’s event log. Every event is recorded when it happens, whether or not an endpoint was listening for it, so you can read what you missed before you had one.

List events
GET/v1/events
Get event
GET/v1/events/{evt}
ModelsExpand Collapse
Event object { id, created_at, data, 5 more }

One event in your brand’s log.

The attribution is a typed pair: a chat event carries chat_id, an invitation_batch.* event carries batch_id, and exactly one of the two is present on any event. They are never both set and never interchangeable.

id: string

Stable id, evt_…. Unique for the life of the event.

created_at: string

When the event happened. For a chat event this is the instant the chat recorded it.

formatdate-time
data: unknown

The event body, exactly what a webhook delivery for this event carries, so the same parser reads both.

seq_from: number

First chat seq this event covers.

formatint64
seq_to: number

Last chat seq this event covers.

formatint64
type: string

What happened, e.g. message.received. The same names an endpoint subscribes to.

batch_id: optional string

The invitation-batch run this event belongs to. Present on invitation_batch.* events only.

chat_id: optional string

The chat this event belongs to, on chat events. A brand-scoped event (brand.escalation_handling_changed) carries its synthetic feed id here instead (brand:<brand_id>), which is load-bearing for ordering and dedup exactly as a chat id is.

EventListResponse object { data, next_cursor }
data: array of Event { id, created_at, data, 5 more }
id: string

Stable id, evt_…. Unique for the life of the event.

created_at: string

When the event happened. For a chat event this is the instant the chat recorded it.

formatdate-time
data: unknown

The event body, exactly what a webhook delivery for this event carries, so the same parser reads both.

seq_from: number

First chat seq this event covers.

formatint64
seq_to: number

Last chat seq this event covers.

formatint64
type: string

What happened, e.g. message.received. The same names an endpoint subscribes to.

batch_id: optional string

The invitation-batch run this event belongs to. Present on invitation_batch.* events only.

chat_id: optional string

The chat this event belongs to, on chat events. A brand-scoped event (brand.escalation_handling_changed) carries its synthetic feed id here instead (brand:<brand_id>), which is load-bearing for ordering and dedup exactly as a chat id is.

next_cursor: string

Pass back verbatim to read the next page. Empty string when the log is exhausted.