# View workflow jobs ```{raw} html ``` Lists the workflow execution jobs that are readable by the current caller. First find the execution ID through this interface, and then query the job details or results. ```text GET https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/executions ``` ## Preparation before calling Prepare a personal access token and target workspace ID that has access to the target workspace. ## Query parameters ::::{div} mo-api-split :::{div} mo-api-split-main ```{raw} html

offsetinteger: Returns the starting position of the list.
limitinteger: Return the quantity.
statusstring: Filter by job status.
execution_modestring: Filter by execution mode.
workflow_namestring: Filter by workflow name.

``` ::: :::{div} mo-api-split-aside ```{raw} html

Request example

``` ```bash curl "https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/executions?offset=0&limit=20" \ -H "X-API-Key: $AI_STUDIO_API_KEY" \ -H "X-Workspace-ID: $WORKSPACE_ID" ``` ::: :::: ## Successful response Returns `200` on success. `data.total` is the total number of matches, and `data.executions` is the job summary for the current page. ::::{div} mo-api-split :::{div} mo-api-split-main ```{raw} html

codestring: `OK` when successful.
msgstring: `OK` when successful.
data.totalinteger: The total number of jobs that meet the filter conditions.
data.executionsobject[]: Current page job summary; empty array when there are no results.
data.executions[].execution_idstring: Execution ID.
data.executions[].workflow_idstring: ID of the workflow to which it belongs.
data.executions[].dispatch_job_idstring: Scheduling job ID; returned when provided by the server.
data.executions[].workflow_namestring: Workflow name; returned when provided by the server.
data.executions[].statusstring: Current status.
data.executions[].execution_modestring: Execution mode.
data.executions[].available_actionsstring[]: Operations allowed in the current state.
data.executions[].cron_expressionstring: Cron expression; only returned in timing mode.
data.executions[].moi_task_idstring: Task ID; returned when the server has assigned it.
data.executions[].moi_case_idstring: Case ID; returned when the server has assigned it.
data.executions[].moi_workflow_def_idstring: Workflow definition identifier; returned when the server has assigned it.
data.executions[].moi_workflow_version_idstring: Workflow version identifier; returned when the server has assigned it.
data.executions[].data_namestring: The name of the data associated with this execution; returned when applicable.
data.executions[].file_idstring: The file ID associated with this execution; returned when applicable.
data.executions[].pause_scopestring: Pause range; returned when in pause state and provided by the server.
data.executions[].errorstring: Current execution error; returned when there is an error.
data.executions[].started_atstring: Start time; may be omitted if not generated.
data.executions[].ended_atstring: End time; may be omitted if not generated.
data.executions[].created_atstring: Creation time; may be omitted if not generated.
data.executions[].updated_atstring: Last updated time; may be omitted if not generated.

``` ::: :::{div} mo-api-split-aside ```{raw} html

Successful response example

``` ```json { "code": "OK", "msg": "OK", "data": { "total": 1, "executions": [ { "execution_id": "exec-001", "dispatch_job_id": "dispatch-001", "workflow_id": "wf-001", "workflow_name": "daily-import", "status": "running", "available_actions": ["pause", "cancel"], "execution_mode": "one_shot", "moi_task_id": "task-001", "moi_case_id": "case-001", "started_at": "2026-08-18T10:00:00Z", "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:01:00Z" } ] } } ``` ::: :::: ## Error response ::::{div} mo-api-split :::{div} mo-api-split-main ```{raw} html

codestring: Error code.
msgstring: Readable error message.
datanull: `null` in an error response.

``` ::: :::{div} mo-api-split-aside ```{raw} html

Error response example

``` ```json { "code": "ErrParamInvalid", "msg": "请求参数无效", "data": null } ``` ::: :::: ## Follow-up operations Use `data.executions[].workflow_id` and `execution_id` [query workflow job details](get-workflow-job.md).