---
title: "Update a channel"
method: PATCH
path: "/v1/channels/{id}"
tags: ["Channels"]
---

# Update a channel

`PATCH /v1/channels/{id}`

## Request

- Base URL: `https://api.merlonix.com`
- URL: `https://api.merlonix.com/v1/channels/{id}`
- Auth: HTTP bearer

Update mutable fields of a channel (name, target, active state, severity filter). At least one field is required. Requires a `write`-scoped key.

## Path parameters

- `id` string, uuid, required

## Request body

- ChannelUpdate: Request body for updating a channel — at least one field required (TD-943).
  - `name` string
  - `target` string
  - `is_active` boolean
  - `severity_filter` string[]

## Response `200`

The updated channel.

- Channel: An alert notification channel (mirrors AlertChannelPublicSchema).
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `kind` 'email' | 'slack_webhook' | 'generic_webhook' | 'teams_webhook' | 'discord_webhook' | 'telegram' | 'google_chat' | 'pagerduty' | 'opsgenie' | 'sms', required
  - `name` string, required
  - `target` string, required: Destination; shape depends on kind (email / webhook URL / token:chat / routing key / E.164).
  - `signing_secret_preview` string, nullable, required: First 6 chars of the webhook signing secret; null for email + slack channels.
  - `is_active` boolean, required
  - `severity_filter` string[], required
  - `created_at` string, date-time, required
  - `last_delivery` object, nullable, required: TD-1220: most-recent alert delivery to this channel; null when none.
    - `status` string
    - `at` string, date-time
    - `error_message` string, nullable

## Other responses

- `400`: Error — canonical envelope with a trace_id.
- `401`: Error — canonical envelope with a trace_id.
- `403`: Error — canonical envelope with a trace_id.
- `404`: Error — canonical envelope with a trace_id.
- `422`: Error — canonical envelope with a trace_id.
- `429`: Error — canonical envelope with a trace_id.

---

[API](https://skmtc.dev/merlonix/apis/merlonix-public-api.md) · [All operations](https://skmtc.dev/merlonix/apis/merlonix-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/merlonix/apis/merlonix-public-api/revisions/2192584bdfcd?raw)