Resume task¶

Resume a paused import task. A successful response does not return the task status. Please check the details again to confirm the progress.

POST https://moi.matrixorigin.cn/newmoi/task/resume

Before you call¶

Prepare the personal access token, target workspace ID, and task ID that have access to the target workspace. First query task details to confirm that the task has been suspended.

The example below uses:

$AI_STUDIO_API_KEY: The actual personal access token, passed through the X-API-Key Header.
$WORKSPACE_ID: The workspace ID of the task to be restored, passed through the X-Workspace-ID Header.
$TASK_ID: Task ID to be restored.

Request example¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/task/resume" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d "{\"task_id\":\"$TASK_ID\"}"

Request body¶

Field	Type	Is it required	Description
`task_id`	string	Yes	The ID of the import task to restore.

Successful response¶

Returns 200 on success and data is null. Continue to query task status and running records to confirm actual progress.

{
  "code": "OK",
  "msg": "OK",
  "data": null
}

The response fields are as follows.

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data`	null	This interface does not return the restored task status.

Error response¶

{
  "code": "ErrForbidden",
  "msg": "permission denied",
  "data": null
}

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`400`	`ErrParamInvalid`	The request body is invalid, or the task is not in the paused state.	Fix JSON and pause the task first.
`403`	`ErrForbidden`	The caller does not have permission to operate the task.	Check workspace and object authorization.
`503`	`ErrCoreAuthorizeUnavailable`	The service is temporarily unable to complete the authorization check.	Try again later.
`200`	`ErrServer`	The service failed to resume the task.	Check both HTTP status and `code`.

Follow-up operations¶

Use the same task ID to Query task details to confirm recovery, and Query running records to track subsequent runs.

Last updated on Sep 3, 2026