更新数据表

PATCH

https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}

该接口用于更新数据表的基本信息，包括数据表的名称等。

该接口支持调用频率上限为 10 QPS（Query Per Second，每秒请求率）

错误码

HTTP状态码	错误码	描述	排查建议
400	1254001	WrongRequestBody	请求体错误
400	1254002	Fail	内部错误，有疑问可咨询客服
400	1254003	WrongBaseToken	app_token 错误
400	1254004	WrongTableId	table_id 错误
400	1254013	TableNameDuplicated	表名重复
403	1254036	Bitable is copying, please try again later.	多维表格副本复制中，稍后重试
404	1254040	BaseTokenNotFound	app_token 不存在
404	1254041	TableIdNotFound	table_id 不存在
429	1254290	TooManyRequest	请求过快，稍后重试
403	1254302	Permission denied.	无访问权限, 常由表格开启了高级权限造成, 请在高级权限设置中添加一个包含应用的群, 给予这个群读写权限
500	1255001	InternalError	内部错误，有疑问可咨询客服

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://open.feishu.cn/open-apis/bitable/v1/apps//tables/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "数据表的新名称"
}'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "name": "数据表的新名称"
  }
}

请求参数

Path 参数

app_token

string

必需

多维表格的唯一标识符 app_token 参数说明示例值："XrgTb4y1haKYnasu0xXb1g7lcSg" 数据校验规则：最小长度：1 字符

table_id

string

必需

多维表格数据表的唯一标识符 table_id 参数说明示例值："tbl1TkhyTWDkSoZ3"

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

name

string

可选

数据表的新名称。请注意：名称中的首尾空格将会被去除。如果名称为空或和旧名称相同，接口仍然会返回成功，但是名称不会被更改。示例值："数据表的新名称" 数据校验规则：长度范围：1 ～ 100 字符正则校验：^[^[]:\/?*]+$

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

name

string

数据表的名称

必需

修改于 2023-01-18 07:27:08

更新多维表格元数据

列出数据表

更新数据表

错误码#

请求参数

返回响应

错误码