---
title: "Update a channel"
description: "Changes a channel's label and account events, and a webhook's URL and headers. `headers` and `events` replace the old values."
canonical: https://docs.rumoro.dev/api/alerts/update-channel
markdown: https://docs.rumoro.dev/api/alerts/update-channel.mdx
---

# Update a channel

`PATCH /v1/channels/{id}`

Changes a channel's label and account events, and a webhook's URL and headers. `headers` and `events` replace the old values.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The channel's id (dest_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `label` |  |  |
| `url` |  | For webhook channels only. |
| `headers` |  | For webhook channels only. Sets the full new set of headers. |
| `events` |  | Sets the full list of account events the channel gets. A webhook can take any of them. Slack, email and Telegram channels take only the attention events (mention.spike, sentiment.negative_spike, keyword.noisy, channel.failing). An empty list turns them all off. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The channel after the change |
| 400 | The channel kind doesn't support one of the events. Slack, email and Telegram accept attention events only |
| 401 | The API key is missing or not valid |
| 404 | No channel with this id |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).