# 查询工作区自动化运行历史

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

读取当前工作区范围内的自动化运行记录。它不是当前用户本人运行列表，也不是某个任务的列表。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-automation-runs
```

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --get "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-automation-runs" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --data-urlencode "limit=50" --data-urlencode "offset=0"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `X-API-Key` | string | 是 | 当前环境的有效个人访问令牌；另需满足工作区访问条件。 |
| `X-Workspace-ID` | string | 是 | 与路径 workspace_id 一致。 |
| `workspace_id` | string | 是 | 工作区 ID，不能混用其他环境的标识。 |
| `status` | string | 否 | 八种运行状态之一；省略不按状态筛选。 |
| `created_from` | string | 否 | RFC 3339 时间，包含起点。 |
| `created_to` | string | 否 | RFC 3339 时间，不包含终点。 |
| `limit` | integer | 否 | 默认50，最大200；按返回的limit继续翻页。 |
| `offset` | integer | 否 | 默认0，负数归零。 |

:::::
::::::
:::::::

## 返回结果

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "run-example",
        "workspace_id": "workspace-example",
        "automation_task_id": "task-example",
        "automation_task_version": 1,
        "trigger_type": "manual",
        "trigger_config_snapshot": {
          "mode": "cron",
          "cron_expression": "TZ=UTC 0 9 * * *"
        },
        "status": "queued",
        "created_at": "2026-11-11T01:00:00Z",
        "updated_at": "2026-11-11T01:00:00Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 成功为0。 |
| `data.items` | object[] | 本页运行记录，空时[]；字段见[运行对象](run-objects.md)。 |
| `data.total` | integer | 当前筛选范围的总条数，不是本页条数。 |
| `data.limit` | integer | 本次生效的页大小。 |
| `data.offset` | integer | 本次生效的偏移。 |

:::::
::::::
:::::::

## 查询范围与分页

按created_at降序、同时间id升序。按返回的offset+limit取下一页，达到total或返回空页时停止；并发新增或状态变化可使偏移分页重复/遗漏，不把它当快照游标。运行ID用于详情/事件/结果，automation_task_id用于任务定义。

此接口不读取automation_task_id、task_id、agent_id、trigger_type或mowl_case_id查询参数；不要依赖它们筛选。按任务查询请使用[任务运行历史](list-task-runs.md)。

参数归一化、时间边界见[查询规则](query-rules.md)，错误与鉴权层次见[错误及环境](errors-environments.md)。SDK/CLI有通用资源调用入口，不能因没有专用列表方法判为功能不可用。
