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.
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
- Replace pluses
- Ignore any trailing equal signs
For example, the URLSafe Base64 encoding of
lX1hwfmQ+AK/k/a/BB0y2n///q2+0KfbdA== converts to
The following list shows the existing endpoints:
Create IM or MIM
Create IM or MIM non-inclusive
Create Room v3
Update Room v3
Room Info v3
Search Rooms v3
List User Streams
Stream Info v2
List Streams for Enterprise v2