---
title: "Update channel"
method: PUT
path: "/v1/projects/{project_id}/channels/{channel_id}"
tags: ["channels"]
---

# Update channel

`PUT /v1/projects/{project_id}/channels/{channel_id}`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/channels/{channel_id}`
- Auth: HTTP bearer

Update a notification channel's settings and event subscriptions.

Required permission: `channels.manage`.

## Path parameters

- `project_id` string, uuid, required
- `channel_id` string, uuid, required

## Request body

- ChannelUpdate: Partial update of a channel. Omitted fields are unchanged.
  - `name` string, nullable
  - `config` object, nullable: Settings merged into the stored configuration. Secret fields that are omitted, empty or still masked keep their stored values.
  - `subscribed_events` string[], nullable: Notification event types to send to this channel. Replaces the current list.
  - `enabled` boolean, nullable: Whether the channel receives deliveries.

## Response `200`

Successful Response

- ChannelResponse: An external destination for project notifications and approval requests.
  - `id` string, uuid, required
  - `project_id` string, uuid, required: Project the channel belongs to.
  - `type` string, required: Channel type, such as `webhook`, `datadog` or `otlp`.
  - `name` string, required
  - `config` object, required: Type-specific settings. Secret values are masked as `****` followed by their last four characters.
  - `subscribed_events` string[]: Notification event types sent to this channel.
  - `enabled` boolean, required: Whether the channel receives deliveries.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `404`: The resource does not exist in this project.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

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