Skip to content
Console
Menu

Queues

Workflows

Getting Started

Authentication

KV Store

Get a realtime member

Gets one client present in a channel.

Gets one client present in a channel.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/realtime_channels/realtime-channel/realtime_members/realtime-member
  • Scope events:read
  • Effect read — nothing is written.
  • Collection realtime_members

#Request

FieldTypeWhat it is
namestringThe name of the member. Required.

#Response

FieldTypeWhat it is
namestring…/realtime_channels/{realtime_channel}/realtime_members/{realtime_member}.
uidstringrtb_<cell><ulid>; never reused. Output only.
metaResourceMetaResource metadata.
client_idstringThe client id its token names. Output only.
datavalueThe member's presence data (set at enter, changed by an update). Output only.
enter_timetimestampWhen the member entered. Output only.
connection_countint32Open connections of this client in the channel. Output only.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#Errors

Every error arrives in the body Errors describes.

#Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/realtime_channels/realtime-channel/realtime_members/realtime-member" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"