腾讯云数据库 AI 服务团队管理（Metadata）

一、接口介绍

接口	方法	功能
/v3/team/create	POST	创建团队
/v3/team/get	POST	获取团队信息
/v3/team/update	POST	更新团队
/v3/team/delete	POST	批量删除团队
/v3/team/list	POST	列出团队

二、创建团队

创建一个新团队。

POST /v3/team/create

三、请求参数

字段	类型	必选	说明
name	string	是	团队名称
description	string	否	团队描述

四、请求示例

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/team/create \\ -d '{"name":"Platform Team","description":"平台团队"}'

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "team_id":"team-abc", "name":"Platform Team", "created_at_ms":1758096000000 }}

六、响应 data

字段	类型	说明
team_id	string	新创建的团队唯一标识 ID
name	string	团队名称
created_at_ms	int	创建时间

七、获取团队信息

按团队 ID 查询团队详细信息。

POST /v3/team/get

八、请求参数

字段	类型	必选	说明
team_id	string	是	团队 ID

九、请求示例

十、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "team_id":"team-abc", "name":"Platform Team", "created_at_ms":1758096000000, "updated_at_ms":1758182400000 }}

十一、响应 data

字段	类型	说明
team_id	string	团队 ID
name	string	团队名称
created_at_ms	int	创建时间
updated_at_ms	int	最后更新时间

十二、更新团队

更新团队名称等属性。

POST /v3/team/update

十三、请求参数

字段	类型	必选	说明
team_id	string	是	待更新的团队 ID
name	string	否	更新后的团队名称

十四、请求示例

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/team/update \\ -d '{"team_id":"team-abc","name":"New Platform Team"}'

十五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "team_id":"team-abc", "updated_at_ms":1758268800000 }}

十六、响应 data

字段	类型	说明
team_id	string	已更新的团队 ID
updated_at_ms	int	最后更新时间

十七、批量删除团队

批量删除指定团队。

POST /v3/team/delete

十八、请求参数

字段	类型	必选	说明
team_ids	string[]	是	待删除的团队 ID 列表

十九、请求示例

20、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "deleted":true }}

21、响应 data

字段	类型	说明
deleted	bool	删除是否成功

22、列出团队

列出指定用户所属的全部团队。

POST /v3/team/list

23、请求参数

字段	类型	必选	说明
user_id	string	是	用户 ID
limit	int	否	每页返回数量
offset	int	否	分页偏移量

24、请求示例

25、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "team_id":"team-abc", "name":"Platform Team", "created_at_ms":1758096000000 }, { "team_id":"team-def", "name":"Data Team", "created_at_ms":1758182400000 } ] }}

26、响应 data

字段	类型	说明
items	array	团队列表
items[].team_id	string	团队 ID
items[].name	string	团队名称
items[].created_at_ms	int	创建时间

27、错误码

HTTP 状态码	错误信息	说明
400	request: Invalid input	请求参数不合法。
401	Missing or invalid Authorization header	Bearer API Key 缺失或格式不正确。
	Missing x-tdai-service-id header	请求头中未携带 x-tdai-service-id。
404	TEAM_NOT_FOUND	指定团队不存在。
409	TEAM_NAME_ALREADY_EXISTS	团队名称已存在。
500	Internal error	服务内部错误，可有限重试。

腾讯云数据库 AI 服务 团队管理（Metadata）