rongshu/.agents/skills/lark-base/references/lark-base-advperm-disable.md

base +advperm-disable

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

停用指定 Base 的高级权限。停用后自定义角色等高级权限功能将不可用。

推荐命令

# 停用高级权限
lark-cli base +advperm-disable \
  --base-token VwGhbYCXQaYGMzsWlEZcBbfMnod

参数

参数	必填	说明
--base-token <token>	是	Base Token，27 位字母数字字符串

API 入参详情

HTTP 方法和路径：

PUT /open-apis/base/v3/bases/:base_token/advperm/enable?enable=false

Path 参数：

参数	必填	说明
base_token	是	Base 的唯一标识，27 位字母数字字符串

Query 参数：

参数	必填	类型	说明
enable	是	bool	固定为 false，表示停用高级权限

API 出参详情

Response：

字段	类型	说明
code	int32	错误码，0 表示成功
message	string	错误信息
data	string	成功时为空

返回值

命令成功后输出 JSON：

{
  "ok": true,
  "data": {
    "success": true
  }
}

工作流

[!CAUTION] 这是高风险写入操作 — 停用高级权限会影响所有已配置的自定义角色，执行前必须向用户确认。

1. 向用户确认 --base-token，并提醒停用会影响已有角色配置
2. 执行命令
3. 确认返回 code: 0 表示停用成功

坑点

• ⚠️ 操作用户必须为 Base 管理员：非管理员调用会返回权限错误
• ⚠️ 停用影响已有角色：停用高级权限后，已创建的自定义角色将失效
• ⚠️ API 路径版本：本接口使用 base/v3，路径必须从原始文档提取，不要用 WebSearch 补全
• ⚠️ data 字段是 JSON 字符串：响应中 data 是 string 类型（非 object），需要双重解析

参考

• lark-base — 多维表格全部命令
• lark-shared — 认证和全局参数