列出智能体团队¶
列出当前身份可读的团队及其版本。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
请求¶
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams?limit=50&offset=0" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
下一页示例:
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams?limit=50&offset=50" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前工作区ID,与产品身份和请求头保持同环境一致。 |
|
查询 |
string |
否 |
名称或说明搜索文本。 |
|
查询 |
string |
否 |
active/deleting/deleted;不填表示不按状态筛选。 |
|
查询 |
integer |
否 |
默认50,最大200;非正/无效按50。 |
|
查询 |
integer |
否 |
默认0;负数按0。 |
普通模式读取至 offset + items.length >= total 或本页 items 为空时停止。并发写入可能改变偏移分页;不要用total当稳定快照。
query 匹配名称或说明,不区分大小写。status 按保存状态匹配;不填写时不会自动排除 deleted。可读范围先过滤,再计算 total 与分页。
成功响应¶
{
"code": 0,
"data": {
"items": [
{
"id": "team-example",
"workspace_id": "workspace-example",
"owner_user_id": "user-example",
"name": "资料整理团队",
"status": "active",
"version": 1,
"membership_version": 2,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z",
"description": "整理与核对资料"
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
错误响应¶
错误与并发处理区分参数、版本、成员/会话状态及准入失败。
最后更新于