Skip to main content
DELETE
Remove Connection By User Id
This endpoint handles multiple connection removal scenarios based on the current connection status:
  • Decline: If the specified user sent you a pending request, decline it
  • Withdraw: If you sent a pending request to the specified user, withdraw it
  • Disconnect: If you’re connected with the specified user, remove the connection

Request

Path Parameters

Headers

Body Parameters

None

Example Request


Response

Success Responses

Decline (200 OK)

When other user sent you a pending request:

Withdraw (200 OK)

When you sent them a pending request:

Disconnect (200 OK)

When you’re connected:

Error Responses

Invalid User ID (400 Bad Request)

Self-Disconnect Attempt (400 Bad Request)

No Connection Found (404 Not Found)

Server Error (500 Internal Server Error)


Notes

  • Smart endpoint that automatically handles the correct action based on connection status
  • Decline: Updates connection status to “declined” and sets respondedAt timestamp
  • Withdraw: Deletes the connection record (allows fresh request later)
  • Disconnect: Deletes the connection record (allows fresh request later)
  • Cannot disconnect from yourself
  • Returns different response formats based on the action taken
  • Rate limiting: 50 requests per 5 minutes