Mute Conversation
Chat — Conversations
Mute Conversation
Set or clear the authenticated user’s mute on a conversation
POST
Mute Conversation
Sets or clears the acting user’s mute on a conversation. Muting suppresses the
Returned when a service/master key omits the required
Returned when
message push for this conversation only — the message is still delivered, socket-emitted, and readable. Timed mutes expire lazily (push resumes once the window passes).
Requires authentication. Acting-user-scoped: an end-user token (Authorization: Bearer <accessToken>) mutes its own membership. A service/master key acts on behalf of a named user via the optional body userId — a service key without userId is rejected, and an end-user token may not name a different user (both consistent with every other per-user write). Requires the chat bundle.
Path Parameters
The ID of the conversation to mute or unmute.
Body Parameters
The mute duration choice — send the choice, never a raw timestamp. One of:
"8h"— mute for 8 hours from now"24h"— mute for 24 hours from now"1w"— mute for 1 week from now"forever"— mute indefinitelynull— clear the mute (unmute)
The acting user whose membership is muted. Service/master keys only — a service key must pass it (there is no implicit session user); an end-user token infers it from the auth token and may not name a different user.
Response
Returns200 with the acting user’s own (self-serialized) member row under currentMember. The mutedUntil / mutedForever fields reflect the new state.
Error Responses
Missing User ID — 400
Missing User ID — 400
userId (it has no implicit session user).Not Found — 404
Not Found — 404
Not a Member — 400
Not a Member — 400
Invalid Body — 400
Invalid Body — 400
duration is not one of the accepted choices (or null).
