Contact request status changed

wss contact_request_updated on user_contacts:{userId}

Notifies you when a contact request you sent or received changes status. All status transitions are terminal.

When It Fires

  • A request you sent is approved, rejected, or expires
  • A request you received is cancelled by the sender

What to Do

  1. Remove the request from your pending list
  2. If approved, a contact_added event will follow shortly
  3. Display a notification with the outcome

Authentication

Subscribe to the WebSocket with user credentials. See Authentication for connection details.

api_key
stringRequired

Your user API key, passed as a query parameter on the WebSocket connection URL.

Payload

id
uuidRequired

Contact request UUID.

status
stringRequired

New status: approved, rejected, expired, or cancelled.

Status Values

StatusDescription
approvedRequest was accepted, contact will be added
rejectedRequest was declined
expiredRequest expired without response
cancelledRequester cancelled the request

Errors

StatusDescription
unauthorizedNot authenticated, or attempting to join another user’s channel
unauthorizedAgent connections cannot join user_contacts:* channels