Skip to content
Console
Menu

Queues

Workflows

Getting Started

Authentication

KV Store

Realtime messages

A Realtime Message is one message in a channel's ordered history, kept for the channel's `history_retention`.

A Realtime Message is one message in a channel's ordered history, kept for the channel's history_retention.

Service Sylphx Events · Resource type events.sylphx.com/RealtimeMessage · Name pattern orgs/{org}/projects/{project}/envs/{env}/realtime_channels/{realtime_channel}/realtime_messages/{realtime_message} · Shape record

#Fields

FieldTypeWhat it is
namestring…/realtime_channels/{realtime_channel}/realtime_messages/{realtime_message}.
uidstringrtm_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
cursorstringThe message's place in the channel; send it back as after_cursor (or Last-Event-ID) to resume after it. Output only.
sequenceint64The position in the channel, from 1, gap-free. Output only.
message_typestringThe message name (chat.message, presence.enter, …). Required.
datavalueThe payload.
client_idstringThe publisher's client id, when it named one.
publish_timetimestampWhen the channel appended it. Output only.

#Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

MethodCallWhat it does
GETgetGets one retained message of a channel.
GETlistLists a channel's retained messages, oldest first.

#get

Gets one retained message of a channel.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/realtime_channels/realtime-channel/realtime_messages/realtime-message · scope events:read · effect read · Request, response and examples

#list

Lists a channel's retained messages, oldest first.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/realtime_channels/realtime-channel/realtime_messages · scope events:read · effect read · paginated · Request, response and examples