Mute or unmute a channel
POST/api/sessions/:sessionId/channels/:channelId/mute
Silences the channel's notifications for this account. The subscription is untouched.
Request
Responses
- 200
- 400
- 403
- 404
- 409
- 503
Channel muted or unmuted
Session not started, or validation failed
The engine refused
No such channel — the id is not among the session's subscribed channels, either because it is wrong or because the channel has not synced into the local collection yet.
The session is not connected — an engine exists for it but is not ready: disconnected, reconnecting, or still initializing, so the request never reached WhatsApp. Wait for ready and retry. A session that was never started answers 400 instead, and the session lifecycle routes answer 409 for a conflicting state rather than this. One window answers this while the session still reads ready: WhatsApp Web periodically reloads its own page and the engine re-injects into it — for those few seconds the answer is a 409 naming the reload; retry shortly.
WhatsApp did not answer within the request budget — the operation may or may not have applied.