Remove Connection

Removes a connection with a user.

Removes a connection with a user.

POSTyourpodURL.symphony.com/pod/v1/connection/user/{uid}/remove

Path parameters

uid*integer (int64)

User ID as a decimal integer

Header parameters

Response

200400401403404500

OK

Body

application/json

formatenum

Example: "TEXT"

TEXTXML

messagestring

Example: "Success"

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/connection/user/{uid}/remove', {
    method: 'POST',
    headers: {
      "sessionToken": "text"
    },
});
const data = await response.json();

Response

200400401403404500

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

📘 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