---
title: "Toggle mute on a live call channel"
method: POST
path: "/channels/{channelId}/events/mute/toggle"
tags: ["channels"]
---

# Toggle mute on a live call channel

`POST /channels/{channelId}/events/mute/toggle`

Toggles the mute state on a live call channel. If the channel is currently unmuted, the participant will be muted (their audio is no longer transmitted to the other party). If already muted, they will be unmuted. This is a real-time telephony control — the effect is immediate and applies to the ongoing call.

The `channelId` identifies a specific participant's leg in the call. Use `POST /calls/current` to discover active channel IDs.

**Permission:** `Calls Write` required.

**Monitoring:** **Required.** This is a live call supervisory control. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `channelId` string, required

## Response `201`

Successfully processed — the mute toggle event has been applied to the channel.

## Other responses

- `400` — Invalid channel ID format.
- `401` — Unauthorized — missing or invalid token, or Monitoring is not enabled on your API key.
- `404` — Channel not found — no active call channel matches the provided ID.
- `500` — Internal server error.
- `502` — Service temporarily unavailable — please retry later.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)