---
title: "Delete a channel"
method: DELETE
path: "/api/v4/channels/{channel_id}"
tags: ["channels"]
---

# Delete a channel

`DELETE /api/v4/channels/{channel_id}`

Archives a channel. This will set the `deleteAt` to the current timestamp in the database. Soft deleted channels may not be accessible in the user interface. They can be viewed and unarchived in the **System Console > User Management > Channels** based on your license. Direct and group message channels cannot be deleted.

##### Permissions
`delete_public_channel` permission if the channel is public,
`delete_private_channel` permission if the channel is private,
or have `manage_system` permission.

## Path parameters

- `channel_id` string, required

## Response `200`

Channel deletion successful

- 38cb7293StatusOK
  - `status` string — Will contain "ok" if the request was successful and there was nothing else to return

## Other responses

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

---

[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)