API
群信息修改
改群资料、置顶等；通常需要管理员权限。
鉴权： Authorization: Bearer sbot_…
POST
Bot Token/api/v1/bots/setChatTitlesetChatTitle
修改群名称；机器人需为群主 / 管理员。
- 必填：
chat_id、title(1..128) - 失败 403 时提示机器人需先成为群主或群管理员
POST
Bot Token/api/v1/bots/setChatDescriptionsetChatDescription
修改群描述；机器人需为群主 / 管理员。
- 必填：
chat_id、description(≤512)
POST
Bot Token/api/v1/bots/setChatPhotosetChatPhoto
修改群头像 URL；机器人需为群主 / 管理员。
- 必填：
chat_id、photo(公开可访问的图片 URL) - 可改用先
/files/upload-credentials+/files/complete拿objectUrl再传
POST
Bot Token/api/v1/bots/pinChatMessagepinChatMessage
把某条会话内的消息标记为「置顶」；会写 `Conversation.pinnedMessageId`。
- 必填：
chat_id、message_id - 群聊须为群主 / 管理员；私聊默认双方均可置顶
POST
Bot Token/api/v1/bots/unpinChatMessageunpinChatMessage
取消单条置顶。
- 必填：
chat_id - 可选：
message_id（若提供，必须与当前置顶消息一致，否则 400；省略则直接清空置顶）
POST
Bot Token/api/v1/bots/unpinAllChatMessagesunpinAllChatMessages
清空该会话置顶。
- 必填：
chat_id