Developer DocumentationDeveloper CertificationDeveloper DaysDeveloper Newsletter

Create Datafeed v1

post https://YOUR-AGENT-URL.symphony.com/agent/v4/datafeed/create

Available on Agent 2.0.0 and above.
Create 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 Messages/Events Stream v4 endpoint.

Note: As of April 2023, this endpoint is deprecated. This endpoint will not be supported anymore in the near future. Please use Datafeed v2.

Other Request Examples

curl -X POST \
https://acme.symphony.com/agent/v4/datafeed/create \
-H "sessionToken: SESSION_TOKEN" \
-H "keyManagerToken: KEY_MANAGER_TOKEN"

curl "https://acme.symphony.com:8444/agent/v2/stream/Z3oQRAZGTCNl5KjiUH2G1n___qr9lLT8dA/message/create" -X POST -H "sessionToken: SESSION_TOKEN" -H "keyManagerToken: KEY_MANAGER_TOKEN" -H "Content-Type: application/json" -d '{
  "message": "<messageML>Hello World</messageML>", 
  "format": "MESSAGEML"
}'

curl "https://acme.symphony.com:8444/agent/v2/stream/Z3oQRAZGTCNl5KjiUH2G1n___qr9lLT8dA/message/create" -X POST -H "sessionToken: SESSION_TOKEN" -H "keyManagerToken: KEY_MANAGER_TOKEN" -H "Content-Type: application/json" -d '{
  "message": "<messageML>Hello World</messageML>", 
  "format": "MESSAGEML",
  "attachments": [
    {
    "id": "internal_7696581411197%2F%2FBGvaY7DSOq2jopwK8gZyA%3D%3D",
    "name": "balloons_over_bagan_header.jpg",
    "size": 62082
    }
  ]
}'

🚧

Datafeed Expiration

The datafeed will expire if it is not read before its capacity is reached.

🚧

Maximum number of Datafeed per Service account

There is a maximum of 5 Datafeed per Service Account configured by default.
This setting can be changed in the API Agent's property file.

Language