列出团队会话¶
列出指定团队的会话元数据。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams/{team_id}/sessions
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
请求¶
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions?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/$TEAM_ID/sessions?limit=50&offset=50" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
参数 |
位置 |
类型 |
必填 |
说明 |
|---|---|---|---|---|
|
路径 |
string |
是 |
当前工作区ID,与产品身份和请求头保持同环境一致。 |
|
路径 |
string |
是 |
团队ID,来自团队列表或创建响应。 |
|
查询 |
integer |
否 |
默认50,最大200;非正/无效按50。 |
|
查询 |
integer |
否 |
默认0;负数按0。 |
普通模式读取至 offset + items.length >= total 或本页 items 为空时停止。并发写入可能改变偏移分页;不要用total当稳定快照。
团队须处于 active。会话按创建时间倒序、context_id排序;context_id用于后续改名、提交和读取消息。
成功响应¶
{
"code": 0,
"data": {
"items": [
{
"workspace_id": "workspace-example",
"team_id": "team-example",
"context_id": "context-example",
"name": "资料整理",
"created_by_moi_user_id": "user-example",
"updated_by_moi_user_id": "user-example",
"version": 1,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z"
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
错误响应¶
错误与并发处理区分参数、版本、成员/会话状态及准入失败。
最后更新于