IM Info

Returns information about a particular IM conversation.

Get information about a partcular IM.

get

/v1/im/{id}/info

Path parameters

idstringrequired

IM streamId

Header parameters

sessionTokenstringrequired

Session authentication token.

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'yourpodURL.symphony.com/pod/v1/im/{id}/info' \
  --header 'sessionToken: text'

200

400

401

403

500

200

{
  "V1IMAttributes": {
    "pinnedMessageId": "vd7qwNb6hLoUV0BfXXPC43___oPIvkwJbQ"
  },
  "IMSystemInfo": {
    "id": "usnBKBkH_BVrGOiVpaupEH___okFfE7QdA",
    "creationDate": 1610520703317,
    "active": true
  }
}

OK

📘 Stream ID

The stream ID can be located in the Symphony web or desktop client by clicking on the timestamp of any message in the conversation. This will open the Message Status module overlay, and the Conversation ID can be found in the overlay footer.

The stream ID in the UI is in Standard Base64 encoding. When the stream ID needs to be used in a URL, it should be in URLSafe Base64 encoding. To obtain the URLSafe Base64 stream ID, replace forward slashes with underscores, replace pluses with minuses, and ignore any trailing equal signs.

See Overview of streams for details.

🚧 Required Permissions

Streams information can only be requested by:

• Members of the IM

• Compliance Officers and Super Compliance Officers who are not members of the stream

• Service Users with the User Provisioning role (members or not members of the stream)

See Bot Permissions for a list of roles and associated privileges.