Delete Channel

​

Overview

​

Request Body

​

Required Parameters

curl -X POST "http://localhost:5001/channel/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2
  }'

const response = await fetch('http://localhost:5001/channel/delete', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    channel_id: 'group123',
    channel_type: 2
  })
});

const data = await response.json();
console.log(data);

import requests

data = {
    "channel_id": "group123",
    "channel_type": 2
}

response = requests.post('http://localhost:5001/channel/delete', json=data)
result = response.json()
print(result)

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    data := map[string]interface{}{
        "channel_id":   "group123",
        "channel_type": 2,
    }
    
    jsonData, _ := json.Marshal(data)
    
    resp, err := http.Post(
        "http://localhost:5001/channel/delete",
        "application/json",
        bytes.NewBuffer(jsonData),
    )
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Printf("%+v\n", result)
}

{
  "status": "ok"
}

​

Response Fields

​

Status Codes

​

Deletion Impact

​

Data Cleanup

​

User Impact

• Member Notification: All members will receive channel dissolution notification
• Conversation Cleanup: Channel removed from all members’ conversation lists
• Message Loss: Message history in the channel will be unrecoverable
• Permission Invalidation: All channel-related permissions immediately invalidated

​

Permission Requirements

​

Personal Channel (channel_type = 1)

• Participants: Any participant in the channel can delete it
• System Administrator: Has permission to delete any personal channel

​

Group Channel (channel_type = 2)

• Group Owner: Only the group owner can dissolve the group
• System Administrator: Has permission to delete any group
• Regular Members: No deletion permission, can only leave the group

​

Security Considerations

​

Deletion Confirmation

1. Permission Verification: Confirm the operator has deletion permission
2. Identity Verification: Require password or verification code input
3. Impact Warning: Clearly inform the scope of deletion impact
4. Final Confirmation: Provide a final chance to cancel

​

Data Backup

• Message Export: Allow export of important messages
• Member List: Save member information for rebuilding
• File Backup: Backup important files in the channel
• Operation Logging: Record detailed information about deletion operations

​

Alternative Solutions

​

Soft Delete

• Hide Channel: Hide from user interface but retain data
• Disable Features: Prohibit sending messages but retain history
• Set Expiration: Set automatic deletion time
• Permission Revocation: Remove all member permissions

​

Archive Processing

• Message Archive: Transfer messages to archive storage
• Read-only Mode: Set to read-only status
• History Viewing: Allow viewing but no operations
• Periodic Cleanup: Regularly clean up archived data

​

Best Practices

1. Permission Control: Strictly control deletion permissions to prevent misoperations
2. Operation Logging: Detailed logging of deletion operations including time, operator, reason
3. Notification Mechanism: Timely notification to all related members
4. Data Backup: Perform data backup before deleting important channels
5. Recovery Mechanism: Provide recovery functionality within a certain time period
6. Batch Deletion: Support batch deletion of multiple channels