Check an export target table name¶

Check whether the target database and table name in a MatrixOne connector can be used in an export configuration.

POST https://moi.matrixorigin.cn/newmoi/connectors/mo/check_table_name

Before you call¶

First get connector details and confirm the target MatrixOne connector. Prepare a personal access token, workspace ID, and connector ID.

The example uses:

$AI_STUDIO_API_KEY: your personal access token.
$WORKSPACE_ID: the target workspace ID.
$CONNECTOR_ID: the MatrixOne connector ID.

Request example¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/connectors/mo/check_table_name" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"connector_id\": \"$CONNECTOR_ID\",
    \"database\": \"analytics\",
    \"table\": \"orders\"
  }"

Request body¶

Parameter	Type	Required	Description
`connector_id`	string	Yes	MatrixOne connector ID.
`database`	string	Yes	Target database name.
`table`	string	Yes	Target table name.

Successful response¶

A successful response returns the validation result. Use it to decide whether to create the export task or change the target table name.

Error response¶

If the connector, database, or table name is invalid, check the request body and submit it again.

Last updated on Sep 3, 2026