Resolve a structured-load backfill start¶

Resolve the backfill start for a structured-load task.

POST https://moi.matrixorigin.cn/newmoi/connectors/structured/v1/source/backfill-start/resolve

Before you call¶

Confirm the structured data source and backfill method. Prepare a personal access token, workspace ID, and connector ID.

Request example¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/connectors/structured/v1/source/backfill-start/resolve" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"connector_id\": \"$CONNECTOR_ID\",
    \"source\": {\"connector_id\": \"$CONNECTOR_ID\", \"source_type\": \"SOURCE_TYPE_MYSQL\", \"database\": \"appdb\", \"schema\": \"public\", \"table\": \"orders\"},
    \"start_mode\": \"auto\"
  }"

Request body¶

Parameter	Type	Required	Description
`connector_id`	string	Yes	Connector ID.
`source`	object	Yes	Structured data source, including type, database, schema, and table information.
`watermark`	object	No	Watermark configuration used to resolve the backfill start.
`start_mode`	string	Yes	Backfill start mode.
`custom_start_value`	string	No	Custom backfill start; provide it when applicable.

Successful response¶

A successful response returns a backfill start that can be used to create a structured-load task.

Error response¶

If the data source or backfill mode is invalid, check the connector and source configuration, then retry.

Last updated on Sep 3, 2026