Trigger a periodic structured import immediately¶
Submit an immediate run for an eligible periodic structured import task.
POST https://api.moi.matrixorigin.cn/v5/task/run-now
Before you call this API¶
Prepare a personal access token for the target workspace and the required source-read or import-run permissions. Install jq and set the example variables. See common information for identity, environments, and result handoff.
Request body¶
curl -X POST "https://api.moi.matrixorigin.cn/v5/task/run-now" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
--data-binary "$(jq -n --arg v0 "$TASK_ID" '{"task_id":$v0}')"
The task must be active, have created or uploading status (1 or 2), already have a Mowl workflow task, and use run_mode=periodic. Supported sources are Kafka, Doris, MySQL, and REST API. MySQL with compute configuration does not use this path. The server rechecks persisted dependencies and current permissions, then triggers the existing periodic workflow. This is not a general endpoint for resuming paused tasks or retrying arbitrary files.
Field |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
Structured import task ID in the current workspace. |
Successful response¶
{
"code": "OK",
"msg": "OK",
"data": null
}
Field |
Type |
Description |
|---|---|---|
|
string |
OK on success; also check the HTTP and business codes. |
|
string |
Response information. |
|
null |
The request has been accepted; no execution result is returned here. |
Error responses¶
Distinguish parameters, capabilities, authorization, and run states using errors and environments. HTTP 200 alone does not establish business success.