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

task_id

string

Yes

Structured import task ID in the current workspace.

Successful response

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

Field

Type

Description

code

string

OK on success; also check the HTTP and business codes.

msg

string

Response information.

data

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.

Last updated on