Skip to main content
DELETE
/
api
/
channels
/
{id}
/
delete
curl -X DELETE "https://your-domain.com/api/channels/ch_abc123/delete" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

true
Permanently deletes a channel and all associated messages, reactions, and member data. This action cannot be undone.

​
Authentication

Requires a valid user session. User must be the channel creator or an admin.

​
Path Parameters

​
id
string
required
The unique identifier of the channel to delete

​
Response

Returns a boolean indicating success.
​
success
boolean
required
true if the channel was deleted successfully
curl -X DELETE "https://your-domain.com/api/channels/ch_abc123/delete" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

true

​
Notes

  • Only the channel creator or admins can delete channels
  • This action permanently deletes:
    • The channel itself
    • All messages in the channel
    • All message reactions
    • All member associations
    • All webhooks associated with the channel
    • All file associations
  • This operation cannot be undone
  • Members will be removed from the channel’s socket room automatically