Accept Connection

Accept the connection request from a requesting user.

Accept the connection request for the requesting user

post

Header parameters

sessionTokenstringRequired

Session authentication token.

Body

application/json

Request body for the Connection APIs

userIdinteger · int64Optional

user id

Example: 769658112378

Responses

200

Success

application/json

400

Client error, see response body for further details.

application/json

401

Unauthorized: Invalid session token.

application/json

403

Forbidden: Caller lacks necessary entitlement.

application/json

404

Not Found: Connection cannot be found.

application/json

500

Server error, see response body for further details.

application/json

post

/v1/connection/accept

HTTPcURLJavaScriptPython

POST /pod/v1/connection/accept HTTP/1.1
Host: yourpodURL.symphony.com
sessionToken: text
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "userId": 769658112378
}

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

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

📘 Note

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

📘 Accepted Connections

For users of the same private pod who are implicitly connected, this endpoint returns the connection with status of "Accepted".

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