List User Streams (Admin)

Returns a list of all the streams of which the specified user is a member, sorted by creation date (ascending - oldest to newest).

Released in 20.16.

Retrieve a list of all streams of which this user is a member, sorted by creation date (ascending). Since SBE 20.16.

POSTyourpodURL.symphony.com/pod/v1/admin/user/{uid}/streams/list

Path parameters

uid*integer (int64)

User ID as a decimal integer

Query parameters

Header parameters

Body

application/json

Stream filtering criteria.

streamTypesarray of StreamType (object)

Types of streams to search for.

includeInactiveStreamsboolean

Whether to include inactive streams in the list of results.

Example: "false"

Response

200204400401403500

OK

Body

application/json

idstring

The stream ID.

crossPodboolean

If true, this is a cross-pod stream.

activeboolean

If true, this stream is active.

streamTypeStreamType (object)

streamAttributesConversationSpecificStreamAttributes (object)

roomAttributesRoomSpecificStreamAttributes (object)

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/admin/user/{uid}/streams/list', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403500

[
  {
    "id": "text",
    "crossPod": false,
    "active": false,
    "streamType": {
      "type": "ROOM"
    },
    "streamAttributes": {
      "members": [
        7215545058313,
        7215545078461
      ]
    },
    "roomAttributes": {
      "name": "text"
    }
  }
]

🚧 Required Permissions

Only service users with the User Provisioning role can use this endpoint.

📘 Overview of streams

A stream is like a container for messages exchanged between two or more users via a given instant message (IM) or chat room. For more information, refer to Overview of streams.