Read Presence Feed

Reads the specified presence feed that was created using the Create Presence feed endpoint. The feed returned includes the user presence statuses that have changed since they were last read.

Starting with SBE 24.1, the API is deprecated

Read a presence status feed.

Returns the current presence status of company (pod) users if it has changed since the last read. Returns up to 500 records at a time.

GETyourpodURL.symphony.com/pod/v1/presence/feed/{feedId}/read

Path parameters

feedId*string

Presence feed ID.

Header parameters

Response

200400401403500

OK

Body

application/json

category*string

Presence status. Possible values are:

• UNDEFINED
• AVAILABLE
• BUSY
• DO_NOT_DISTURB
• ON_THE_PHONE
• BE_RIGHT_BACK
• IN_A_MEETING
• AWAY
• OUT_OF_OFFICE
• OFF_WORK
• OFFLINE

Example: "AWAY"

userIdinteger (int64)

The ID of the user to whom the presence state relates.

Example: 14568529068038

timestampinteger (int64)

The time, in milliseconds since Jan 1 1970, when the presence state was set.

Example: 1533928483800

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/presence/feed/{feedId}/read', {
    method: 'GET',
    headers: {
      "sessionToken": "text"
    },
});
const data = await response.json();

Response

200400401403500

[
  {
    "category": "AVAILABLE",
    "userId": 14568529068038,
    "timestamp": 1533928483800
  },
  {
    "category": "OFFLINE",
    "userId": 974217539631,
    "timestamp": 1503286226030
  }
]

When calling this as an OBO-enabled endpoint, use the OBO User Authenticate token for sessionToken.