查询目标消息接收连接

查询目标消息接收连接。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/ingress-connections

调用前准备

准备可访问目标工作区并有相应动作权限的个人访问令牌。路径工作区与 X-Workspace-ID 一致。示例使用 jq;变量、对象与状态见公共说明。

查询参数

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/ingress-connections" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "target_kind=agent" \
  --data-urlencode "target_workspace_id=$AGENT_WORKSPACE_ID" \
  --data-urlencode "target_id=$AGENT_ID"

三项目标参数同时提供。当前动作不分页,total 等于本次返回的 items 数,不使用其他资源列表的 limit/offset 模板。

字段

类型

是否必填

说明

target_kind

string

是

agent 或 team。

target_workspace_id

string

是

目标所属工作区。

target_id

string

是

目标 ID。

成功响应

{
  "code": 0,
  "data": {
    "items": [],
    "total": 0
  }
}

字段

类型

说明

code

integer

成功时为 0。

data

object

结果对象,字段见公共对象说明。

错误响应

按 HTTP 状态、业务结果和错误字段处理,见错误与环境。来源与版本冲突时读取当前状态,不替换身份、资源或请求 ID 自动重试。

最后更新于