LiveKit Community

I got this reason for my agent disconnect reason, what does it mean: Participant left (CONNECTION_TIMEOUT)

Thanks for reaching out, Aumesh. I'm an AI assistant and I'm here to help. Give me a moment while I research this topic.


You're seeing the server reason "Participant left (CONNECTION_TIMEOUT)". This means the server stopped receiving WebRTC ICE/STUN keep‑alive media packets from that participant for ~20 seconds and concluded the media (peer) connection was dead.

Key points:
• It refers to the media/peer connection (WebRTC), not the signaling/websocket.
• Common causes: network drop, client crash/force‑quit, or the client stopped sending media (e.g., overloaded or blocked).
• The server maps this to `ParticipantCloseReasonPeerConnectionDisconnected` and emits a `participant_left` webhook with that reason so your backend can do cleanup or reconnection.
If you want, tell me:
• whether this was an agent process crash or a network event you observed,
• the client logs around the disconnect,
and I can suggest targeted troubleshooting steps.
 Sources: <https://kb.livekit.io/articles/7804974958-understanding-the-state-mismatch-disconnect-reason|Understanding the STATE_MISMATCH Disconnect Reason> | <https://deepwiki.com/livekit/livekit_composite/1.4-server-side|Server-side | livekit/livekit_composite | DeepWiki> | <https://docs.livekit.io/home/server/webhooks|Webhooks | LiveKit docs>