---
title: "POST /voiceChannels/{voiceChannelID}"
method: POST
path: "/voiceChannels/{voiceChannelID}"
tags: ["voice"]
---

# POST /voiceChannels/{voiceChannelID}

`POST /voiceChannels/{voiceChannelID}`

Edit a voice channel. All fields are optional, only fields that are provided will be changed.

## Path parameters

- `voiceChannelID` string, uuid, required

## Request body

- object
  - `name` string
  - `description` string
  - `restrictedTo` object, nullable — An object describing who can access this voice channel. If set to null, then the voice channel will be public.
    - `invitedUsers` string[] — A list of emails corresponding to the users that can access this voice channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.
    - `invitedGroups` string[] — Only these groups will be able to access the voice channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.

## Response `200`

Successful response

## Other responses

- `400` — Invalid request body
- `401` — API Key is missing or invalid

---

[API](https://skmtc.dev/heartbeat/apis/heartbeat-api.md) · [All operations](https://skmtc.dev/heartbeat/apis/heartbeat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/heartbeat/heartbeat-api/revisions/6c3cf537d508/schema)