Released in 1.48.
Removes a connection with a user.
Pods from all users involved need to have
crossPodenabled between them.
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.
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)|