Remove Connection

Removes a connection with a user.

Removes a connection with a user.

post

/v1/connection/user/{uid}/remove

Path parameters

uidanyrequired

User ID as a decimal integer

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 \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/connection/user/{uid}/remove'

200

400

401

403

404

500

200

{
  "format": "TEXT",
  "message": "Success"
}

OK

📘 Note

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

📘 HTTP 400

This endpoint returns 400 Bad Request when the users are not connected. For example, when a user has not yet accepted a connection request from another user.

Connection Behaviour

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.

The following table shows the connection current behaviors:

Initial Connection Status	Request Action	New Connection Status
ACCEPTED	Remove	None (the connection no longer exist)
PENDING_INCOMING	Remove	REJECTED
REJECTED	Remove	PENDING_INCOMING