---
title: "Deletes channels asynchronously"
method: POST
path: "/channels/delete"
tags: ["product:chat"]
---

# Deletes channels asynchronously

`POST /channels/delete`

Allows to delete several channels at once asynchronously

Sends events:
- channel.deleted

## Request body

- DeleteChannelsRequest, nullable
  - `cids` string[], required — All channels that should be deleted
  - `hard_delete` boolean — Specify if channels and all ressources should be hard deleted

## Response `201`

Successful response

- DeleteChannelsResponse, nullable
  - `duration` string, required — Duration of the request in milliseconds
  - `result` object — Map of channel IDs and their deletion results
  - `task_id` string

## Other responses

- `400` — Bad request
- `429` — Too many requests

---

[API](https://skmtc.net/getstream/apis/stream-api.md) · [All operations](https://skmtc.net/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getstream/stream-api/versions/3dba86aaa0d8/schema)