Skip to content

Realtime

realtime_presence_update

Update a presence member's info and/or refresh its TTL

Tool

realtime_presence_update

Update a presence member's info and/or refresh its TTL

Update a presence member's info and/or refresh its TTL

Behavior

HTTP
POST /realtime/presence/update

Arguments

NameTypeRequiredDescription
infostringArbitrary JSON metadata for the member (<=10KB serialized)
channelstringChannel name, "namespace:rest"
member_idstringAct for a synthetic member id instead of the caller identity (backend integrations)
ttl_secondsintegerPresence entry TTL in seconds (1-3600)

Response

FieldTypeAlwaysDescription
memberobjectThe entered/updated member
channelstringChannel name

Try it

Update a presence member's info and/or refresh its TTL.

When to use

Update a presence member's info and/or refresh its TTL

Example

Ask your agent something like this:

Update a presence member's info and/or refresh its TTL.

The agent will invoke realtime_presence_update with these arguments:

{
  "channel": "<channel>"
}

Esc

Start typing to search the docs.

navigateselect