---
title: "Mute a chat"
method: PUT
path: "/service_agents/me/push_mutes/{chat_id}"
tags: ["Service Agent"]
---

# Mute a chat

`PUT /service_agents/me/push_mutes/{chat_id}`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/me/push_mutes/{chat_id}`
- Auth: none declared

Mutes the chat for the calling agent: the `chat_message` notifications of the chat stop. Mentions
(`chat_mentioned`) of the agent in the chat are still delivered. The call is idempotent: muting a
muted chat returns `200` with the settings.

The chat must belong to the customer of the calling agent. The agent does not have to be a participant.
A chat that does not exist, that belongs to another customer, or that cannot be read is reported
identically as `404 CHAT_NOT_FOUND`.

The mute stays when the chat is deleted or the agent leaves it; it has no effect then.

## Path parameters

- `chat_id` string, uuid, required

## Response `200`

The push notification settings after the change.

- PushManagerSettings: The push notification settings of the calling agent.
  - `kinds` object, required: Every kind the agent can switch with `true` for on and `false` for off: `chat_mentioned`, `chat_message`, `conversation_message`, `case_assigned` and `case_note`.
  - `muted_chat_ids` string[], required: The chats the agent muted, the oldest mute first. Empty when no chat is muted.

## Other responses

- `400`: Invalid request (INVALID_ARGUMENT).
- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `404`: Resource not found (NOT_FOUND).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-11** `690cef25e02a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/me/push_mutes/:chat_id/put.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/dbc83827530e?raw)
