set_friends_category

set_friends_category写操作扩展
移动好友到指定分组

Call via POST http://127.0.0.1:3000/set_friends_category (JSON params as the body) or WebSocket.

Parameters

Param Type Required Default Description
uin uint 要移动的好友 QQ 号
categoryId int 目标分组 ID
categoryName string 目标分组名称(必须唯一且完全匹配)

Returns (data)

成功时返回空数据。

Returns the standard OneBot envelope; the data shape is not yet documented.

Examples

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/set_friends_category \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"uin":0,"categoryId":0,"categoryName":""}'
Using an AI assistant?

MCP-capable clients can discover and call this action directly — no hand-written HTTP. See MCP.