---
title: "Patch a channel"
method: PUT
path: "/api/v4/channels/{channel_id}/patch"
tags: ["channels"]
---

# Patch a channel

`PUT /api/v4/channels/{channel_id}/patch`

Partially update a channel by providing only the fields you want to update. Omitted fields will not be updated. The fields that can be updated are defined in the request body, all other provided fields will be ignored.
##### Permissions
If updating a public channel, `manage_public_channel_members` permission is required. If updating a private channel, `manage_private_channel_members` permission is required.

## Path parameters

- `channel_id` string, required

## Request body

- object
  - `name` string — The unique handle for the channel, will be present in the channel URL
  - `display_name` string — The non-unique UI name for the channel
  - `purpose` string — A short description of the purpose of the channel
  - `header` string — Markdown-formatted text to display in the header of the channel

## Response `200`

Channel patch successful

- 38cb7293Channel
  - `id` string
  - `create_at` integer — The time in milliseconds a channel was created
  - `update_at` integer — The time in milliseconds a channel was last updated
  - `delete_at` integer — The time in milliseconds a channel was deleted
  - `team_id` string
  - `type` string
  - `display_name` string
  - `name` string
  - `header` string
  - `purpose` string
  - `last_post_at` integer — The time in milliseconds of the last post of a channel
  - `total_msg_count` integer
  - `creator_id` string

## Other responses

- `400` — Invalid or missing parameters in URL or request body
- `401` — No access token provided
- `403` — Do not have appropriate permissions
- `404` — Resource not found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)