Reject Connection

Reject the connection request for the requesting user.

Reject the connection between the requesting user and request sender. If both users are in the same private pod, an error will be returned because both users have an implicit connection which cannot be rejected.

POSTyourpodURL.symphony.com/pod/v1/connection/reject

Header parameters

Body

application/json

userIdinteger (int64)

user id

Example: 769658112378

Response

200400401403404500

Success

Body

application/json

userIdinteger (int64)

user id

Example: 769658112378

statusenum

Connection status between the requesting user and the request sender

Example: "ACCEPTED"

PENDING_INCOMINGPENDING_OUTGOINGACCEPTEDREJECTED

firstRequestedAtinteger (int64)

unix timestamp when the first request was made

Example: 1470018073812

updatedAtinteger (int64)

unix timestamp on the last updated date

Example: 1471018076255

requestCounterinteger (int32)

number of requests made

Example: 1

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v1/connection/reject', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403404500

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

This endpoint allows the user to reject a specific connection request. To define which connection request is to be rejected, the userId of the user who initiated the connection request must be included in the body.

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

📘 Rejected Connections

Reject the connection between the requesting user and request sender. If both users are in the same private pod, an error will be returned because both users have an implicit connection which cannot be rejected.

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
None (connection did not exist)	Connect	PENDING_OUTGOING
PENDING_INCOMING	Accept	ACCEPTED
PENDING_INCOMING	Reject	REJECTED