更新块
PATCH
/docx/v1/documents/{document_id}/blocks/{block_id}
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1770001 | invalid param | 确认传入的参数是否合法 |
| 404 | 1770002 | not found | 确认文档是否已被删除 |
| 400 | 1770003 | resource deleted | 确认资源是否已被删除 |
| 400 | 1770004 | too many blocks in document | 确认文档 Block 数量是否超上限 |
| 400 | 1770005 | too deep level in document | 确认文档 Block 层级是否超上限 |
| 400 | 1770006 | schema mismatch | 确认文档结构是否合法 |
| 400 | 1770007 | too many children in block | 确认指定 Block 的 Children 数量是否超上限 |
| 400 | 1770008 | too big file size | 确认上传的文件尺寸是否超上限 |
| 400 | 1770010 | too many table column | 确认表格列数是否超上限 |
| 400 | 1770011 | too many table cell | 确认表格单元格数量是否超上限 |
| 400 | 1770012 | too many grid column | 确认 Grid 列数量是否超上限 |
| 400 | 1770013 | relation mismatch | 确认图片、文件等资源的关联关系是否正确，插入图片、文件需先上传素材 |
| 400 | 1770014 | parent children relation mismatch | 确认 Block 父子关系是否正确 |
| 400 | 1770015 | single edit with multi document | 确认 Block 所属文档与指定的 Document 是否相同 |
| 400 | 1770019 | repeated blockID in document | 确认 Document 中的 BlockID 是否有重复 |
| 400 | 1770020 | operation denied on copying document | 确认 Document 是否正在创建副本中 |
| 400 | 1770021 | too old document | 确认指定的 Document 版本过旧 |
| 400 | 1770022 | invalid page token | 确认 DocumentID 是否合法 |
| 400 | 1770024 | invalid operation | 确认操作是否合法 |
| 400 | 1770025 | operation and block not match | 确认指定 Block 应用对应操作是否合法 |
| 400 | 1770026 | row operation over range | 确认行操作下标是否越界 |
| 400 | 1770027 | column operation over range | 确认列操作下标是否越界 |
| 400 | 1770028 | block not support create children | 确认指定 Block 添加 Children 是否合法 |
| 400 | 1770029 | block not support to create | 确认指定 Block 是否支持创建 |
| 400 | 1770030 | invalid parent children relation | 确认指定操作其父子关系是否合法 |
| 400 | 1770031 | block not support to delete children | 确认指定 Block 是否支持删除 Children |
| 400 | 1770033 | raw content size exceed limited | 纯文本内容大小超过限制 |
| 400 | 1770034 | operation count exceed limited | 当前请求中涉及单元格个数过多，请拆分成多次请求 |
| 400 | 1770035 | resource count exceed limit | 当前请求中资源的数目超限，请拆分成多次请求。各类资源上限为：ChatCard 200 张，File 200 个，MentionDoc 200 个，MentionUser 200 个，Image 20 张，ISV 20 个，Sheet 5 篇，Bitable 5 篇。 |
| 400 | 1770038 | resource not found | 未查询到插入的资源或资源无权限插入，请检查资源标识是否正确。 |
| 403 | 1770032 | forbidden | 确认是否拥有合法权限 |
| 500 | 1771001 | server internal error | 服务器内部错误 |
| 500 | 1771006 | mount folder failed | 挂载文档到云空间目录失败 |
| 500 | 1771002 | gateway server internal error | 网关服务内部错误 |
| 500 | 1771003 | gateway marshal error | 网关服务解析错误 |
| 500 | 1771004 | gateway unmarshal error | 网关服务反解析错误 |
| 503 | 1771005 | system under maintenance | 系统服务正在维护中 |
请求参数
Path 参数
Query 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/docx/v1/documents/doxcnePuYufKa49ISjhD8Ih0ikh/blocks/doxcnO6UW6wAw2qIcYf4hZpFIth?document_revision_id&client_token&user_id_type' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"update_text_elements":{
"elements":[
{
"mention_user":{
"user_id":"ou_b828441a457cf078b7abdd4ceda99ea8"
}
},
{
"text_run":{
"content":"测试",
"text_element_style":{
"background_color":2,
"bold":true,
"italic":true,
"strikethrough":true,
"text_color":2,
"underline":true
}
}
},
{
"text_run":{
"content":"文本",
"text_element_style":{
"italic":true
}
}
},
{
"mention_doc":{
"obj_type":1,
"token":"doccntTMGsK3nFff3OybhbYdpxf",
"url":"https://ming.feishu.cn/docs/doccntTMGsK3nFff3OybhbYdpxf"
}
},
{
"reminder":{
"create_user_id":"ou_b828441a457cf078b7abdd4ceda99ea8",
"expire_time":"1647961200000",
"is_notify":true,
"notify_time":"1647961200000"
}
}
]
}
}'响应示例响应示例
{
"code": 0,
"data": {
"block": {
"block_id": "doxcnuOmySC0keKGCiPyzu29F6i",
"block_type": 2,
"parent_id": "doxcnAJ9VRRJqVMYZ1MyKnayXWe",
"text": {
"elements": [
{
"mention_user": {
"user_id": "ou_b828441a457cf078b7abdd4ceda99ea8"
}
},
{
"text_run": {
"content": "测试",
"text_element_style": {
"background_color": 2,
"bold": true,
"italic": true,
"strikethrough": true,
"text_color": 2,
"underline": true
}
}
},
{
"text_run": {
"content": "文本",
"text_element_style": {
"italic": true
}
}
},
{
"reminder": {
"create_user_id": "ou_b828441a457cf078b7abdd4ceda99ea8",
"expire_time": "1647961200000",
"is_notify": true,
"notify_time": "1647961200000"
}
}
],
"style": {}
}
},
"client_token": "8aac2291-bc9e-4b12-a162-b3cf15bb06bd",
"document_revision_id": 117
},
"msg": ""
}
扫码加入交流群修改于 2025-10-21 04:18:58