Skip to content

更新知识空间节点标题

此接口用于更新节点标题

Tip: 此接口目前仅支持文档(doc)、新版文档(docx)和快捷方式。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/update_title
HTTP MethodPOST
接口频率限制100 次/分钟
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可wiki:node:update 更新知识空间节点信息 wiki:wiki 查看、编辑和管理知识库

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

路径参数

名称类型描述
space_idstring知识空间ID
示例值:"6946843325487912356"
node_tokenstring节点token
示例值:"wikcnKQ1k3pcuo5uSK4t8Vabcef"

请求体

名称类型必填描述
titlestring节点新标题
示例值:"新标题"

请求体示例

json
{
    "title": "新标题"
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {}
}

错误码

HTTP状态码错误码描述排查建议
400131001rpc fail服务报错,请稍后重试,或者拿响应体的header头里的x-tt-logid咨询oncall定位。
400131002param err通常为传参有误,例如数据类型不匹配。请查看具体接口报错信息,报错不明确时请咨询oncall
400131004invalid user非法用户。请咨询oncall
400131005not found未找到相关数据,例如id不存在。相关报错信息参考: - member not found:用户不是知识空间成员(管理员),无法删除。 - identity not found: userid不存在,无法添加/删除成员。 - space not found:知识空间不存在 - node not found:节点不存在 - document not found:文档不存在 报错不明确时请咨询oncall
400131006permission denied权限拒绝,相关报错信息参考: - wiki space permission denied:知识库权限鉴权不通过,需要成为知识空间管理员(成员)。 - node permission denied:文档节点权限鉴权不通过,读操作需要具备节点阅读权限,写操作(创建、移动等)则需要具备节点容器编辑权限。 - no source parent node permission:需要具备原父节点的容器编辑权限。 - no destination parent node permission:需要具备目标父节点的容器编辑权限,若移动到知识空间下,则需要成为知识空间管理员(成员)。 注意:应用访问或操作文档时,除了申请 API 权限,还需授权具体文档资源的阅读、编辑或管理权限。 请参考以下步骤操作: 1. 当遇到资源权限不足的情况:参阅如何给应用授权访问知识库文档资源。 2. 也可直接将应用添加为知识库管理员(成员):参阅如何将应用添加为知识库管理员(成员)。 3. 若无法解决或报错信息不明确时:请咨询技术支持
400131007internal err服务内部错误,请勿重试,拿返回值的header头里的x-tt-logid咨询oncall定位。

内容来源:飞书开放平台 · 自动爬取整理