查询资源操作列表

查询工作区中的智能体资源异步操作。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/operations

调用前准备

准备可访问目标工作区的个人访问令牌和目标工作区 ID。

请求参数

输入示例

curl "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/operations" -H "X-API-Key: $AI_STUDIO_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

路径参数

字段	类型	是否必填	说明
workspace_id	string	是	与 X-Workspace-ID 一致的工作区 ID。

查询参数

字段	类型	是否必填	说明
type	string	否	按操作类型筛选。
resource_type	string	否	按关联资源类型筛选。
resource_id	string	否	按关联资源 ID 筛选。
status	string	否	按 accepted、running、succeeded、failed 或 canceled 筛选。
limit	integer	否	单页返回数量。
offset	integer	否	返回偏移量。

成功响应

响应示例

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

字段说明

字段	类型	说明
code	integer	请求处理成功时为 0。
data	object	响应数据。
data.items	object（对象数组）	当前页的资源操作。
data.items[].operation_id	string	操作 ID。
data.items[].type	string	操作类型。
data.items[].resource_type	string	关联资源类型。未设置时不返回。未设置时可省略。
data.items[].resource_id	string	关联资源 ID。未设置时不返回。未设置时可省略。
data.items[].message	string	操作说明。未设置时可省略。
data.items[].status	string	操作状态。取值：accepted、running、succeeded、failed、canceled。
data.items[].progress	integer	操作进度。
data.items[].result	object	成功结果。未设置时不返回。未设置时可省略。
data.items[].error	object	失败信息。未设置时不返回。未设置时可省略。
data.items[].created_at	string	创建时间，采用 RFC 3339 格式。
data.items[].updated_at	string	最近更新时间，采用 RFC 3339 格式。
data.items[].completed_at	string	完成时间，未完成时可能省略。未设置时可省略。
data.total	integer	符合筛选条件的操作总数。
data.limit	integer	本次采用的单页数量。
data.offset	integer	本次采用的返回偏移量。

错误响应

响应示例

{
  "code": 6,
  "message": "unauthenticated"
}

字段说明

字段	类型	说明
code	integer	错误代码。
message	string	面向调用者的错误信息。

最后更新于 2026 年 10 月 19 日