Create Datafeed

Creates a new real time messages / events stream ("datafeed"). The datafeed provides messages and events from all conversations that the user is in. The types of events surfaced in the datafeed can be found in the Real Time Events list.

Returns the ID of the datafeed that has just been created. This ID should then be used as input to the Read Datafeed endpoint.

Number of active feeds

In the vast majority of the use cases, your bot should have only one active feed.

The platform however supports up to 20 feeds per service user. If you try to create a 21st feed, you will receive a 403 error code. In that case you need to delete one of your active feeds (i.e. get the list of feeds using List Datafeed, then Delete Datafeed on one of the listed feeds).

Create a new real time messages / events stream ("datafeed").

Available on Agent 2.57.0 and above.

The datafeed provides messages and events from all conversations that the user is in. The types of events surfaced in the datafeed can be found in the Real Time Events list. (see definition on top of the file)

Returns the ID of the datafeed that has just been created. This ID should then be used as input to the Read Messages/Events Stream v4 endpoint.

post

/v5/datafeeds

Header parameters

sessionTokenstringrequired

Session authentication token.

keyManagerTokenstringrequired

Key Manager authentication token.

Body

tagstring · max: 100

A unique identifier to ensure uniqueness of the datafeed.

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'youragentURL.symphony.com/agent/v5/datafeeds' \
  --header 'sessionToken: text' \
  --header 'keyManagerToken: text' \
  --header 'Content-Type: application/json'

201

400

401

500

201

{
  "id": "371f465fb97b5d1027d20a5e7085863a_f",
  "type": "fanout"
}

Datafeed sucessfully created.