List User Streams

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

Retrieve a list of all streams of which the requesting user is a member, sorted by creation date (ascending).

post

Query parameters

skipanyoptional

No. of results to skip.

limitanyoptional

Max no. of results to return. If no value is provided, 50 is the default.

Header parameters

sessionTokenanyrequired

Session authentication token.

Body

streamTypesobject[]optional

Types of streams to search for.

Example: [{"type":"IM"},{"type":"ROOM"}]

includeInactiveStreamsbooleanoptional

Whether to include inactive streams in the list of results.

Example: false

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/streams/list' \
  --header 'Content-Type: application/json' \
  --data '{
    "streamTypes": [
      {
        "type": "IM"
      },
      {
        "type": "ROOM"
      }
    ],
    "includeInactiveStreams": "false"
  }'

200

204

400

401

403

500

200

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

OK

Request Example

curl -X POST \
https://acme.symphony.com/pod/v1/streams/list \
-H "sessionToken: SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
	"streamTypes": [
  	{"type": "IM"},
    {"type": "ROOM"},
    {"type": "POST"}
  ],
  "includeInactiveStreams": true
}'

streamTypes

streamTypes: A list of stream types (defined as an object) that will be returned. Options are IM (1-1 instant messages), ROOM (rooms), POST (the user's wall).

{
	"streamTypes": [
    {"type": "IM"}, 
    {"type": "ROOM"}, 
    {"type": "POST"}
  ],
	"includeInactiveStreams": true
}

📘 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.