diff --git a/docs-site/docs/server/api.md b/docs-site/docs/server/api.md
index 1016fdd..7b67100 100644
--- a/docs-site/docs/server/api.md
+++ b/docs-site/docs/server/api.md
@@ -12,7 +12,7 @@
 Authorization: Bearer <token>
 ```
 
-Token 由 `/api/im/auth/login` 接口签发。
+Token 由 `/api/im/auth/login` 接口签发。当前 IM 登录不做过期功能，只校验 `userId + UserSig` 是否匹配。
 
 ---
 
@@ -50,7 +50,7 @@ POST /api/im/auth/login
 { "token": "eyJ..." }
 ```
 
-> 登录态更新由业务侧重新登录完成。
+> 重复登录会覆盖当前会话；SDK 侧不做生命周期检测或旧登录兼容。
 
 ---
 
@@ -69,7 +69,7 @@ WSS /ws/im?token=<token>&appId=<appId>
 ### 发送消息
 
 ```
-POST /api/im/messages
+POST /api/im/messages/send
 Authorization: Bearer <token>
 Content-Type: application/json
 ```
@@ -165,6 +165,49 @@ Authorization: Bearer <token>
 
 ---
 
+### 会话扩展
+
+```
+PUT /api/im/conversations/{targetId}/hidden?appId=&chatType=SINGLE&hidden=true
+PUT /api/im/conversations/{targetId}/group?appId=&chatType=SINGLE&groupName=重要客户
+GET /api/im/conversation-groups?appId=
+GET /api/im/conversation-groups/{groupName}?appId=
+```
+
+### 好友扩展
+
+```
+DELETE /api/im/friends?appId=
+PUT /api/im/friends/{friendId}/group?appId=&groupName=同事
+GET /api/im/friends/groups?appId=
+GET /api/im/friends/groups/{groupName}?appId=
+```
+
+### 黑名单校验
+
+```
+GET /api/im/blacklist/check?appId=&targetUserId=user_002
+```
+
+### 群扩展
+
+```
+POST /api/im/groups/{groupId}/owner
+PUT /api/im/groups/{groupId}/attributes
+POST /api/im/groups/{groupId}/attributes/delete
+```
+
+管理端补充：
+
+```
+POST /api/im/admin/groups/{groupId}/owner?appId=
+PUT /api/im/admin/groups/{groupId}/attributes?appId=
+POST /api/im/admin/groups/{groupId}/attributes/delete?appId=
+POST /api/im/admin/groups/{groupId}/read-receipts?appId=
+```
+
+---
+
 ## 版本管理服务（/api/v1/updates/ 和 /api/v1/rn/）
 
 ### 检查 App 更新
@@ -258,6 +301,7 @@ Content-Type: application/json
   "creatorId": "user_001",
   "memberIds": ["user_001", "user_002"],
   "adminIds":  ["user_001"],
+  "extAttributes": "{\"department\":\"sales\"}",
   "createdAt": "2026-04-24T10:00:00"
 }
 ```