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

一、接口介绍

Metadata 团队成员管理接口用于管理团队的成员关系。共4个接口：

接口	方法	功能
/v3/team-member/add	POST	添加成员
/v3/team-member/remove	POST	移除成员
/v3/team-member/list	POST	列出成员
/v3/team-member/get	POST	获取成员信息

二、添加成员

向指定团队添加成员。

POST /v3/team-member/add

三、请求参数

字段	类型	必选	说明
team_id	string	是	团队 ID
user_id	string	是	用户 ID
role	string	否	成员角色，如 admin、member

四、请求示例

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-member/add \\ -d '{"team_id":"team-abc","user_id":"user-123","role":"member"}'

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "team_id":"team-abc", "user_id":"user-123", "role":"member", "joined_at_ms":1758096000000 }}

六、响应 data

字段	类型	说明
team_id	string	团队 ID
user_id	string	用户 ID
role	string	成员角色
joined_at_ms	int	加入时间

七、移除成员

从指定团队移除成员。

POST /v3/team-member/remove

八、请求参数

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

九、请求示例

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-member/remove \\ -d '{"team_id":"team-abc","user_id":"user-123"}'

十、响应示例

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

十一、响应 data

字段	类型	说明
removed	bool	移除是否成功

十二、列出成员

列出指定团队的全部成员。

POST /v3/team-member/list

十三、请求参数

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

十四、请求示例

十五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "user_id":"user-123", "username":"alice", "role":"admin", "joined_at_ms":1758096000000 }, { "user_id":"user-456", "username":"bob", "role":"member", "joined_at_ms":1758182400000 } ] }}

十六、响应 data

字段	类型	说明
items	array	成员列表
items[].user_id	string	用户 ID
items[].username	string	用户名
items[].role	string	成员角色
items[].joined_at_ms	int	加入时间

十七、获取成员信息

查询指定团队中某个成员的详细信息。

POST /v3/team-member/get

十八、请求参数

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

十九、请求示例

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-member/get \\ -d '{"team_id":"team-abc","user_id":"user-123"}'

20、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "user_id":"user-123", "username":"alice", "role":"admin", "joined_at_ms":1758096000000 }}

21、响应 data

字段	类型	说明
user_id	string	用户 ID
username	string	用户名
role	string	成员角色
joined_at_ms	int	加入时间

22、错误码

HTTP 状态码	错误信息	说明
400	request: Invalid input	请求参数不合法。
401	Missing or invalid Authorization header	Bearer API Key 缺失或格式不正确。
404	TEAM_MEMBER_NOT_FOUND	成员不存在。
409	MEMBER_ALREADY_EXISTS	成员已在团队中。
500	Internal error	服务内部错误，可有限重试。

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