Overview of Streams

A Stream is like a container for messages exchanged between two or more users via a given instant message (IM), multi-party instant message (MIM), or chat room.

Each Stream has a unique ID also known as a Conversation ID, that is returned when the IM, MIM, or chat room is created using the Create Instant Message, Create Non-inclusive Instance Message, and Create Room v3 endpoints respectively. This ID can then be used in subsequent endpoints to perform operations on the IM, MIM, or chat room.

On the Symphony web or desktop client, this ID can be found by clicking on the timestamp of any message in the conversation. This will open the Message Status module, where the Conversation ID can be found, as shown in the following picture.

Message Status

Message Status

The Conversation ID in the Symphony Web Client is in Standard Base64 encoding. Conversation IDs returned in API responses are in URLSafe Base64 encoding.

URLSafe Base64 conversion

To obtain the URLSafe Base64 Conversation ID:

  • Replace forward slashes / with underscores _
  • Replace pluses + with minuses -
  • Ignore any trailing equal signs =

For example, the URLSafe Base64 encoding of lX1hwfmQ+AK/k/a/BB0y2n///q2+0KfbdA== converts to lX1hwfmQ-AK_k_a_BB0y2n___q2-0KfbdA.


Overview of Streams


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.