List runs for an automation task¶
Read runs for a task definition, then use returned run IDs to retrieve details, events, and results.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-automation-tasks/{automation_task_id}/runs
Request parameters¶
curl --get "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/agent-automation-tasks/$AUTOMATION_TASK_ID/runs" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--data-urlencode "limit=50" --data-urlencode "offset=0"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
A personal access token valid in the current environment; workspace access is also required. |
|
string |
Yes |
Must match path workspace_id. |
|
string |
Yes |
Workspace ID; do not mix identifiers from other environments. |
|
string |
No |
One of eight run states. Omission does not filter by state. |
|
string |
No |
RFC 3339 timestamp, inclusive start. |
|
string |
No |
RFC 3339 timestamp, exclusive end. |
|
integer |
No |
Default 50, maximum 200. Paginate using the returned limit. |
|
integer |
No |
Default 0; negative values become 0. |
|
string |
Yes |
Automation task definition ID, not a run ID. |
Results¶
{
"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
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object[] |
Run records on this page; [] when empty. See run objects for fields. |
|
integer |
Total records matching the current filters, not the number on this page. |
|
integer |
Effective page size. |
|
integer |
Effective offset. |
Query scope and pagination¶
Sorts by created_at descending, then id ascending for ties. Fetch the next page with returned offset+limit. Stop at total or an empty page. Concurrent insertions or state changes may cause duplicates or omissions in offset pagination; it is not a snapshot cursor. Use run IDs for details/events/results, and automation_task_id for task definitions.
A valid task ID with no matching runs can return an empty list. This entry point does not first read the parent task, so a 200 empty list does not prove that the parent exists.
See query rules for parameter normalization and time boundaries, and errors and environments for error and authentication layers. SDK/CLI clients offer general resource invocation. The lack of a dedicated list method does not imply an unavailable capability.