Skip to main content
DELETE
Remove Connection
Removes the connection relationship between the authenticated user and the specified user. The behavior depends on the current connection state:
  • Pending (sent by current user) — withdraws the request (record is deleted).
  • Pending (sent by other user) — declines the request (status updated to "declined").
  • Accepted — disconnects both users (record is deleted).

Path Parameters

userId
string
required
The Sublay user ID (UUID) of the other user.

Response

On success, returns HTTP 200. When withdrawn or disconnected:
message
string
Human-readable description of the action taken.
action
string
"withdraw" or "disconnect".
When declined:
id
string
Connection record ID.
status
string
"declined".
respondedAt
string
ISO timestamp of when the request was declined.

Error Responses

See Also