Skip to main content
POST
/
channel
/
info
curl -X POST "http://localhost:5001/channel/info" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 1,
    "ban": 0
  }'
{
  "status": "ok"
}

Overview

Update or add basic information for channels, including channel type, large group identifier, mute status, etc.

Request Body

Required Parameters

channel_id
string
required
Channel ID
channel_type
integer
required
Channel type
  • 1 - Personal channel
  • 2 - Group channel

Optional Parameters

ban
integer
default:0
Whether to mute
  • 0 - Allow speaking
  • 1 - Mute all members
disband
integer
default:0
Whether to disband channel
  • 1 - Disband channel (irreversible)
send_ban
integer
default:0
Whether to prohibit sending messages (0=not prohibited, 1=prohibited). When prohibited, all members in the channel cannot send messages. Personal channels can receive messages but cannot send messages.
allow_stranger
integer
default:0
Whether to allow strangers to send messages (0=not allowed, 1=allowed) (this configuration currently only supports personal channels) Personal channel: If AllowStranger is 1, strangers can send messages to the current user. For example: if the current account needs to accept stranger messages, channel_id is the current user’s uid
curl -X POST "http://localhost:5001/channel/info" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "group123",
    "channel_type": 2,
    "large": 1,
    "ban": 0
  }'
{
  "status": "ok"
}

Response Fields

status
string
required
Operation status, returns "ok" on success

Status Codes

Status CodeDescription
200Channel info updated successfully
400Request parameter error
404Channel does not exist
500Internal server error

Parameter Details

Channel Type (channel_type)

ValueTypeDescriptionFeatures
1Personal channelOne-on-one private chatOnly two members, no group features
2Group channelMulti-user group chatSupports multiple members, group management features

Mute Status (ban)

ValueDescriptionScopeManagement Permission
0Allow speakingAll members can send messages normallyGroup owner and admins can modify
1Mute allOnly admins can send messagesOnly group owner can modify