Get Connection

Get connection status, i.e. check if the calling user is connected to the specified user.

The status of the connection invitation to another user.

get

/v1/connection/user/{userId}/info

Path parameters

userIdanyrequired

user Id

Header parameters

sessionTokenanyrequired

Session authentication token.

Responses

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'yourpodURL.symphony.com/pod/v1/connection/user/{userId}/info'

200

400

401

403

404

500

200

{
  "userId": 769658112378,
  "status": "ACCEPTED",
  "firstRequestedAt": 1470018073812,
  "updatedAt": 1471018076255,
  "requestCounter": 1
}

OK

📘 Note

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

• Pods from all users involved need to have crossPod enabled between them.

📘 404 Not Found

A 404 Not Found error indicates either:

• The specified user doesn’t exist.

• The calling user and specified user are not connected because a Create Connection request has not yet been sent.

📘 Internal Connections

Users who belong to the same private pod are implicitly connected. Getting the connection status with an internal user will return the corresponding connection object with a status of ACCEPTED.

Connection Status

Currently, there are four possible connection status:

• PENDING_INCOMING: The specified user requested to connect with the calling user.

• PENDING_OUTGOING: The calling user requested to connect with the specified user.

• ACCEPTED: The two users are connected.

• REJECTED: The two users are not connected.