Only the Chinese version of this page is provided currently. The English version will be provided soon.
Help & Documentation>腾讯云数据库 AI 服务>Memory 应用指南>开发者参考>V3 版本>HTTP>Metadata>团队成员管理

团队成员管理

Last updated: 2026-09-23 21:01:01

On this page:

接口介绍

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
否
分页偏移量

请求示例

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/list \\
  -d '{"team_id":"team-abc"}'

响应示例

{
  "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"}'

响应示例

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

响应 data

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

错误码

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
服务内部错误，可有限重试。
中国站 - English